--- title: "Add widgets to a custom dashboard" slug: "add-widgets-to-a-custom-dashboard-1" updated: 2026-09-12T15:51:52Z published: 2026-09-12T15:51:52Z canonical: "docs.trellix.com/add-widgets-to-a-custom-dashboard-1" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Add widgets to a custom dashboard A custom dashboard must contain at least one widget, and you can add up to five widgets per custom dashboard. To add a widget: 1. Navigate to **Main Menu** ![Helix_MegaMenu.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-209bd257-0dfc-f5f1-1063-dac290c8ea6f(6).png?sv=2026-02-06&spr=https&st=2026-11-19T22%3A30%3A20Z&se=2026-11-19T23%3A30%3A20Z&sr=c&sp=r&sig=AqGLJMvnOgPimaoIpwAOLZiCCGVQ0Wg6ZgtozZqKAnc%3D) > **Dashboard** > **Custom**. 2. Open the custom dashboard and click **Add Widget**. 3. On the **Details** tab of the Configure Widget window, do the following: 1. Enter a mandatory title for the widget. 2. Enter an optional description of what the widget does. 3. Choose a **Visualization Type** to display the results of your search query. 4. Click **Next** and on the **Query** tab of the Configure Widget window, do the following: 1. From the **Time Window** menu, select a period of time in which your query should search. 2. From the **Results** menu, select how many results to display in the widget. 3. From the **Width** menu, select the horizontal size of the widget as a percentage of screen width. 4. In the **Search Query** box, enter a TQL query. ### Tip The TQL query must resolve successfully to create the widget. If the TQL query does not resolve, Helix will show an error message to help you fix the query. For example, depending on the Visualization Type you chose, you must include one of the following transforms in your TQL query: - **Table:** `groupby` or `table` - **Pie:** `groupby` or `histogram` - **Bar:** `groupby` or `histogram` For more information about the TQL syntax, click **Query Syntax Help** in the Helix UI, or see the [TQL Reference Guide](https://docs.trellix.com/bundle/helixconnect_tql). 5. (Optional) Click **Preview** to view the widget on your custom dashboard without saving it. 5. Click **Save**.