# Table Widget

## Table Widget

### What is the Table Widget?

The Table widget is a widget type available in Birdie Dashboards. Instead of visualizing data as a chart, it presents metric values in a structured grid where rows are defined by one breakdown dimension and columns by another. This makes it easy to scan and compare exact figures across two dimensions simultaneously, such as seeing how each feedback area performed week by week over the last month.

The Table widget is the right choice when precision matters more than visual pattern recognition. Where a chart communicates trends and relative differences at a glance, a table communicates exact values across a full matrix of categories and time periods.

#### How to extract the most value from the Table Widget?

Use the Table widget when you need to present granular data that viewers may want to read, reference, or export. It works best when you want to answer questions such as:

* How many feedback responses did each area receive in each of the last four weeks?
* How does feedback volume break down across all areas and time periods in a single view?
* Which specific combination of area and date had the highest or lowest count?

The **Transpose axis** option adds further flexibility by swapping rows and columns so that dates become rows and categories become columns, which can improve readability depending on how many items each dimension contains.

<img src="/files/jBWRFfrIpWAnOkJsndJu" alt="Table widget preview" width="563">

### Setting up a Table Widget

{% stepper %}
{% step %}

#### Select the widget type

When adding a new widget to your dashboard, select **Table** from the widget type options at the top of the configuration panel.
{% endstep %}

{% step %}

#### Add a title and subtitle

In the **Title** field, enter a clear name for your widget. You can also add an optional **Subtitle** to provide additional context for other users viewing the dashboard.
{% endstep %}

{% step %}

#### Configure the data source

Navigate to the **Setup** tab. In the **Data** section, select the **Metric** you want to populate the table with. For example, choose **Overall** to display aggregate feedback counts across all sources.
{% endstep %}

{% step %}

#### Configure the rows

The **Rows** section controls what appears in each row of the table.

* **Primary breakdown**: Select the dimension that will define each row. For example, selecting **Areas** will render one row per feedback area.
* **Selection**: Choose which specific items within the primary breakdown to include. By default, all available items are selected.
* **Limit to**: Toggle this on and set a number to cap how many rows are shown in the table. When disabled, all items in the selection are displayed.
  {% endstep %}

{% step %}

#### Configure the columns

The **Columns** section controls what appears in each column of the table.

* **Secondary breakdown**: Select the dimension that will define each column. For example, selecting **Date** will render one column per time period, showing metric values for each row at each point in time.
* **Sort by**: Optionally, define how columns are ordered.

{% hint style="info" %}
When **Date** is selected as the secondary breakdown, the number of columns generated depends on the date range and time aggregation set in the **Filter** tab. A 30-day range with weekly aggregation will produce approximately four date columns.
{% endhint %}
{% endstep %}

{% step %}

#### Configure display settings

Still in the **Setup** tab, the **Display settings** section contains one option:

* **Transpose axis**: Enable this to swap the rows and columns of the table. When active, the secondary breakdown dimension (such as Date) becomes the rows, and the primary breakdown dimension (such as Areas) becomes the columns. Use this when one dimension has significantly more items than the other, to produce a more readable layout.
  {% endstep %}

{% step %}

#### Set filters

Navigate to the **Filter** tab to control the time range and granularity of the data shown.

* **Date range**: Select the period you want the table to cover. The default is **Last 30 days**.
* **Time aggregation**: Choose how date-based columns are grouped. The default is **Week**, which generates one column per week within the selected date range.
* **Advanced filters**: Use the **Add filter** option to refine the data further, for example by a specific tag, sentiment, or source. You can also enable **Ignore global filter** if you want this widget to display independently of any dashboard-level filters.
  {% endstep %}

{% step %}

#### Save the widget

Once you are satisfied with the configuration, click **Save changes** to add the Table widget to your dashboard.

{% hint style="info" %}
Remember to save the Dashboard itself after setting up the widget, otherwise your changes will not be persisted.
{% endhint %}
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ask.birdie.ai/voice-of-customer/dashboards-and-reporting/dashboard-widgets/table-widget.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.