# Dashboard tabs
Tabs allow you to organize widgets within a dashboard into distinct, named sections — making it easier to navigate complex dashboards and group related data without creating multiple separate dashboards.
### Overview
When a dashboard grows to cover multiple topics or teams, scrolling through a long list of widgets becomes inefficient. Tabs let you divide a dashboard's content into clearly labelled sections. Each tab holds its own set of widgets, and viewers switch between them with a single click.
Tabs are created and managed in dashboard edit mode. Viewers see the tab navigation automatically.
### Adding a Tab
{% stepper %}
{% step %}
**Open the dashboard in edit mode**
Navigate to the dashboard you want to edit and click **Edit** in the top right corner of the page.
{% endstep %}
{% step %}
**Add a new tab**
Click **+ Add Tab** on the right side of the tab bar. A new tab will appear in the tab row with a default name ready to be edited.
{% endstep %}
{% step %}
**Name the tab**
Type a name for the tab directly in the tab input field. Tab names can be up to 50 characters long. Press **Enter** or click away to confirm.
{% endstep %}
{% step %}
**Add widgets to the tab**
With the new tab selected, add widgets to it as you normally would. Widgets are always scoped to the tab that is active when they are created.
{% endstep %}
{% step %}
**Save the dashboard**
Click **Save dashboard** in the top right corner to apply your changes. {% endstep %} {% endstepper %}
{% hint style="info" %}
Each dashboard supports a maximum of 8 tabs.
{% endhint %}
{% endstep %}
{% endstepper %}
### Renaming a Tab
Open the dashboard in edit mode, click directly on the tab name, and type the new name. The 50 character limit applies. Click **Save dashboard** to confirm.
{% hint style="warning" %}
If you enter a name longer than 50 characters, a validation message will appear and the name will not be saved until it is shortened.
{% endhint %}
### Deleting a Tab
{% hint style="info" %}
Deleting a tab removes all widgets contained within it. This action cannot be undone. Make sure you no longer need the widgets on that tab before proceeding.
{% endhint %}
Open the dashboard in edit mode and hover over the tab you want to delete. Click the trash icon that appears to the right of the tab name, then click **Save dashboard** to persist the deletion. To undo before saving, click **Discard changes** — a confirmation modal will appear before any unsaved changes are lost.
### Navigating Tabs in View Mode
In view mode, the tab bar is displayed below the dashboard title and description. Click any tab name to switch to that tab's content. The active tab is indicated by an underline.
Tabs are always visible to anyone with access to the dashboard — no additional configuration is required.
### Limits and Constraints
| Constraint | Limit |
| -------------------------- | ------------- |
| Maximum tabs per dashboard | 8 |
| Maximum widgets per tab | 20 |
| Maximum tab name length | 50 characters |
{% hint style="info" %}
Widget limits apply per tab, not per dashboard. A dashboard with 4 tabs can hold up to 80 widgets in total.
{% endhint %}
### Troubleshooting & FAQs
**Q: The "+ Add Tab" button is not visible. Why?** A: The button is hidden when the dashboard is not in edit mode.
**Q: I see a "Tab name cannot exceed 50 characters" message. What should I do?** A: Shorten the tab name to 50 characters or fewer. The name will not save until it meets the character limit.
**Q: I accidentally deleted a tab. Can I recover it?** A: If you have not yet clicked **Save dashboard**, click **Discard changes** to revert all unsaved edits. If the dashboard was already saved, the tab and its widgets cannot be recovered.
**Q: Can I reorder tabs?** A: Yes, tabs can be reordered in the edit mode. Hover your mouse on them and the reorder icon will appear on the left of the tab name. Click on it and drag the tab to the position you want it to be.
**Q: Do tabs affect how a dashboard is shared?** A: No. When you share a dashboard, all tabs are visible to the recipient. It is not possible to share individual tabs independently.
---
# 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-tabs.md?ask=
```
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.