# Add a Custom Table Widget

Use a custom table when you need row-level details, for example, one row per issue.

* The preview shows example data and the total number of items in the selected data source.
* Use a custom table for granular data. For grouped counts, use a custom visualization instead.

<figure><img src="https://884876233-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3XMLdV8zRg847RmGmZ%2Fuploads%2Fgit-blob-b09ffbb88d04b8777b930626eea109ed137a4e69%2Fadd_widget_table.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

### Screen areas

| Area        | Description                                                                                  |
| ----------- | -------------------------------------------------------------------------------------------- |
| Widget name | Title that appears on the report tile. Edit before adding.                                   |
| Data source | The dataset for the table, for example **Issues**.                                           |
| Columns     | Choose which fields appear as columns. Select, clear, and reorder.                           |
| Preview     | Live preview of the table with the selected columns. Shows sample rows and total item count. |
| Add widget  | Adds the configured table to the report.                                                     |

**To create a custom table widget:**

1. In **Custom Reports**, select **ADD WIDGET > Custom Table**.
2. In **Widget name**, enter a clear title, for example, Critical issues table.
3. In the **Data source**, select the dataset.
4. In **Columns**, select the fields to display and drag to set the order.
5. Review the **Preview** to confirm the layout.
6. Select **ADD WIDGET**.