---
title: "List widget"
slug: "list-widget"
updated: 2026-06-15T14:33:12Z
published: 2026-06-15T14:33:12Z
canonical: "help.gong.io/list-widget"
stale: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.gong.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List widget

> **Who can use this**: Business admin
> 
> **Available on**: Gong Forecast
> 
> **Ideal for**: RevOps

![Steps to build metrics, dashboards, and add widgets for data visualization.](https://cdn.us.document360.io/2837c190-3ec8-4120-9116-6d427e774667/Images/Documentation/KPI widget.png)

## What’s a list widget

List widgets are account record list widgets based on predefined list views.

List widgets support all dashboard date picker types and updates the widget results based on the date selection made in the dashboard.

## Building a list widget

> [!NOTE]
> **Note:**
> 
> Your profile must include the relevant [permission](/v1/docs/revenue-analytics-permissions) to create and manage widgets to dashboards

**To build a list widget:**

1. Select your dashboard, click **+New widge**t and select **List** from the gallery.

![](https://cdn.us.document360.io/2837c190-3ec8-4120-9116-6d427e774667/Images/Documentation/image(759).png)
2. In the dashboard header, click the edit icon ![](https://cdn.us.document360.io/2837c190-3ec8-4120-9116-6d427e774667/Images/Documentation/pencil_DS.png) to rename your widget and, optionally, + **Add description**.
3. Under **List**, select a predefined account [list view](/v1/docs/managing-list-views). If you can’t find the view you’re looking for, click **Manage list views** and create one.
4. After selecting a view, you’ll notice a default filter is applied to the widget, and the account’s owner ID is set to be dynamic and respond to whatever is selected in your dashboard. You can change it to fixed values:

![](https://cdn.us.document360.io/2837c190-3ec8-4120-9116-6d427e774667/Images/Documentation/image(757).png)

> [!NOTE]
> Note:
> 
> If you select fixed values for the team member, the widget would no longer respond to selections made on the dashboard level.
5. In addition to the Owner ID filter, you may add any [filter](/v1/docs/filtering-metric-deals) (**+Add filter**) that defines which accounts qualify to be included in the widget.
6. When you’re happy with the **Preview** results on the right, click **Save**.

| ![](https://cdn.us.document360.io/2837c190-3ec8-4120-9116-6d427e774667/Images/Documentation/image-1723022223315.png) Visit our [Academy](https://academy.gong.io/courses/explore-gongs-revenue-analytics) and find out how to utilize your dashboards to boost efficiencies and refine revenue operations |
| --- |

A team member who manages the business entities in Gong, such as deal and forecast boards. [Find my Business admin](/v1/docs/find-your-technical-or-business-admin).

Gong’s full Forecast package for next-level forecasting and revenue optimization. Access to features depends on your [company’s plan and your assigned seat](/v1/docs/plans-and-seats).

A team member who manages and optimizes revenue-related workflows by managing business entities such as metrics, targets, and dashboards.