---
schema_version: "1"
id: da2adfead673053bf95f72461eb626fd6ad5db1b913428f16bf7f4c08cda5f00
title: Create a Repeater Widget
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/analytics/264-0-0/bi_dashboard_repeater_widgets_create.md
canonical_url: https://help.salesforce.com/s/articleView?id=analytics.bi_dashboard_repeater_widgets_create.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 309253cd4f6ffa036f1c128976813deec4ac976b0dcac0ae00a7be253d0347d3
description: A repeater widget is easy to create because you make just one custom layout using fields from a row of data. For each row of data in a query, the custom layout repeats in a scrollable list.
products:
  - CRM Analytics
  - Cross Cloud
release: "264"
---
# Create a Repeater Widget

A repeater widget is easy to create because you make just one custom layout using fields from a row of data. For each row of data in a query, the custom layout repeats in a scrollable list.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d192299e36">User Permissions
              Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d192299e36 ">To create a dashboard:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d192299e36 ">Create and Edit Analytics Dashboards</td>

          </tr>
        </tbody>
      </table>

1. Add a repeater widget to your dashboard (1), and then add a query (2). For best results, use a grouping in your query, such as a compare or pivot table.
    
    ![Adding a repeater widget and query](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-analytics-bi-264-0-0-production-enus/ec791473-f5b4-4f64-a656-9104f455d966/bi/images/bi/bi_dashboard_repeater_add_choose_query.png)
2. Add and arrange text, numbers, charts, and images.
    
    ![Adding widgets to a repeater widget](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-analytics-bi-264-0-0-production-enus/ec791473-f5b4-4f64-a656-9104f455d966/bi/images/bi/bi_dashboard_repeater_add_contents.png)
    
    When you add a widget to a repeater widget, you see values from the first row of query data.
    
    When you’re done, your customized layout repeats in a scrollable list.
    
    ![Example repeater widget](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-analytics-bi-264-0-0-production-enus/ec791473-f5b4-4f64-a656-9104f455d966/bi/images/bi/bi_dashboard_repeater_preview.png)
    
    To preview repeater widget content, change the size of the repeater widget container. Adjust the layout if needed, and click **Done** to save your repeater widget content.