---
schema_version: "1"
id: 5dea528ce4ec04f82843d894217e754cc34865a5cd04b2747ec3c9a7cc3729ef
title: Record List
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/experience/264-0-0/rss_record_list_view.md
canonical_url: https://help.salesforce.com/s/articleView?id=experience.rss_record_list_view.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 72ccbec3b98e1afc8d2b84fca82c78355a62e66025ca6b52ebf6da68d583181c
description: The Record List component shows a list of records on the Record List page. Users can view records, switch between record list views, and create records directly from the list view. If a user has no access to a particular list view, they see the Recently Used list view instead.
products:
  - Experiences
release: "264"
---
# Record List

The Record List component shows a list of records on the Record List page. Users can view records, switch between record list views, and create records directly from the list view. If a user has no access to a particular list view, they see the Recently Used list view instead.

When you create a custom navigation menu item using the Salesforce Object type, it automatically links to a list of the records for the selected object. Templates provide a page to display such a list of records. This generic page is called the Record List page. It’s used for all objects in your site that don’t have a custom page assigned to them.

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-experience-communities-264-0-0-production-enus/bf7df212-91a1-4fa3-a007-4d6f3e3b470b/images/icon_note.png)

Note There are a few things to keep in mind when using the Record List component:

- The Record List component supports all Object Home page supported objects.
- You can use the Record List component on any page in your site. We recommend adding it to custom list views that you create. You can also create a navigation menu item to link to that page with its internal page URL.
- We advise against using the Record List component to show products in a B2B Commerce store. A product Record List doesn't respect user entitlements and could expose information to users that you don't want them to see.
- On a mobile device, if a user taps any field in the Record List component, including a field containing a URL, they’re directed to the full record detail page.

1. Select the **Record List** component on the Record List page.
2. In the property editor, configure the properties for the component.
    
    <table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
            <colgroup>
              <col style="width:28.000000000000004%">
              <col style="width:72%">
            </colgroup>
            <thead class="slds-text-title_caps ">
              <tr class="">
                <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d20503e75">Property</th>
                <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d20503e78">Details</th>
              </tr>
            </thead>
            <tbody>
              <tr class="">
                <td data-label="Property" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e75 ">
                  <samp class="parmname">Number of Records</samp>
                </td>

                <td data-label="Details" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e78 ">
                  <p>The number of entries retrieved to show in the list view. The default is
                    25.</p>
                  <p>When the compact layout is selected, this property controls the number
                    of records shown. If there are more than 25 records, users click a link to see
                    the full list of records. The maximum number of records for the compact layout
                    is 100.</p>
                  <p style="margin-bottom:0;">When the full layout is selected, this property controls the
                    number of records initially shown. As a user scrolls down, more records are
                    displayed. The maximum number of records per page is 100, but this limit
                    doesn't apply when the full layout is selected on desktop.</p>
                </td>

              </tr>
              <tr class="">
                <td data-label="Property" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e75 ">
                  <samp class="parmname">Layout</samp>
                </td>

                <td data-label="Details" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e78 ">
                  <p>Choose from full, standard, or compact layout. The
                    compact layout is ideal for showing short lists of
                    information in a narrow column or when displaying your site
                    on a mobile device. When a page using the full layout is
                    viewed on a mobile device, the page automatically adjusts to
                    a more mobile-friendly layout. To display the compact layout
                    on mobile, explicitly select
                    <strong class="uicontrol">Compact</strong>.
                  </p>
                  <p>When choosing the
                    layout, consider the following:</p><a name="rss_record_list_view__record_list_layout_limitations"><!-- --></a>
                  <ul id="rss_record_list_view__record_list_layout_limitations">
                    <li id="rss_record_list_view__full_layout_limitations"><a name="rss_record_list_view__full_layout_limitations"><!-- --></a>When using the full
                      layout, use a column width of at least 50% of the
                      page. We also recommend that you don’t place another
                      component below the Record List component on the page.<ul>
                        <li>Full layout has a minimum height of 700
                          pixels. If you place a component below the full
                          layout of the Record List component, the Record
                          List can overlap with the component that’s
                          underneath it.</li>
                        <li>Full layout uses infinite scrolling. If you
                          reference an object that contains many records,
                          infinite scrolling can prevent site members from
                          ever seeing the component below the Record List
                          component.</li>
                      </ul>
                    </li>
                    <li>Standard layout has some differences in display.<ul>
                        <li dir="ltr">Only the first four fields of the
                          list view are displayed.</li>
                        <li dir="ltr">When there is no data for the list
                          view to display the Record List component is
                          hidden.</li>
                      </ul>
                    </li>
                    <li id="rss_record_list_view__compact_layout_limitation"><a name="rss_record_list_view__compact_layout_limitation"><!-- --></a>Compact layout works
                      in any size column. However, <strong class="uicontrol">View
                        All</strong> will always redirect to the object
                      home (for example, case list or account list). We
                      recommend that you create a standard page and add
                      the compact list there. This arrangement avoids
                      issues that can arise when the full list for object
                      home has been deleted.</li>
                  </ul>
                  <p style="margin-bottom:0;">If there aren’t records to display for either a
                    standard or compact list view, the component is
                    hidden.</p>
                </td>

              </tr>
              <tr class="">
                <td data-label="Property" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e75 ">
                  <samp class="parmname">Object Name</samp>
                </td>

                <td data-label="Details" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e78 ">
                  <p>The Salesforce object whose records you want to show. The
                    dropdown shows the supported objects. The component supports
                    all Object Home page objects. See <a href="https://help.salesforce.com/s/articleView?id=experience.networks_napili_supported_objects.htm&amp;release=264.0.0&amp;type=5" title="Check out the list of all the objects supported by out-of-the-box components and pages in Experience Builder templates.">Objects Supported by Out-of-the-Box Components and Pages in Experience Builder Templates</a>.</p>
                  <p style="margin-bottom:0;">If
                    <strong class="uicontrol">Page’s Object Name</strong> name is
                    selected, only <code>Page’s
                                                Filter Name</code> is available in the Filter Name
                    field.
                  </p>
                </td>

              </tr>
              <tr class="">
                <td data-label="Property" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e75 ">
                  <samp class="parmname">Filter Name</samp>
                </td>

                <td data-label="Details" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e78 ">The list view to show for the selected object. The
                  dropdown shows only list views that are valid for the object
                  you select.</td>

              </tr>
              <tr class="">
                <td data-label="Property" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e75 ">
                  <samp class="parmname">Allow list pinning</samp>

                  <sup>
                    <a href="https://help.salesforce.com/s/articleView?id=experience.rss_record_list_view.htm&amp;release=264.0.0&amp;type=5"><sup>1</sup></a>
                  </sup>
                </td>

                <td data-label="Details" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e78 ">
                  <p>Lets users select their preferred default view for a
                    record list. Enabled by default.</p>
                  <p>Lists, as elsewhere in
                    Salesforce, can’t be unpinned, but users can select a
                    new list to change their default view.</p>
                  <p style="margin-bottom:0;"> Pinned
                    lists almost always override menu and component list
                    settings. The exception is when the navigation menu for
                    a component receives its filter name from the name of
                    the page—like <code>My
                                                Accounts</code>. To allow users to see their
                    pinned lists, create at least one more menu item that
                    takes <code>default</code> as
                    the list view.</p>
                </td>

              </tr>
              <tr class="">
                <td data-label="Property" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e75 ">
                  <samp class="parmname">Allow inline edit</samp>
                  <sup>
                    <a href="https://help.salesforce.com/s/articleView?id=experience.rss_record_list_view.htm&amp;release=264.0.0&amp;type=5"><sup>1</sup></a>
                  </sup>
                </td>

                <td data-label="Details" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e78 ">Lets users edit individual fields in a list. Enabled by
                  default.</td>

              </tr>
              <tr class="">
                <td data-label="Property" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e75 ">
                  <strong class="uicontrol">Header Configuration</strong>
                </td>

                <td data-label="Details" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e78 ">Click to expand.</td>

              </tr>
              <tr class="">
                <td data-label="Property" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e75 ">
                  <samp class="parmname">Show list actions</samp>

                  <sup>
                    <a href="https://help.salesforce.com/s/articleView?id=experience.rss_record_list_view.htm&amp;release=264.0.0&amp;type=5"><sup>2</sup></a>
                  </sup>
                </td>

                <td data-label="Details" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e78 ">
                  <p>Displays available list view controls, such as new,
                    sharing, filter, and any custom actions that you’ve created.
                    Enabled by default.</p>
                  <ul>
                    <li>Users require necessary permissions for the viewed
                      object to use the <strong class="uicontrol">New</strong> button
                      on the component to create records.</li>
                    <li>For shared views, users need appropriate permissions
                      to see the data.</li>
                    <li>Related Lists for Campaign members have quick
                      filters to narrow results, but the resulting views
                      can’t be saved or shared.</li>
                    <li>Site members can use search and quick filters to
                      quickly find information in their current session.
                      Users can click <span style="vertical-align:text-bottom;display:inline-block;"><img style="margin-bottom:0;" src="https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-experience-communities-264-0-0-production-enus/bf7df212-91a1-4fa3-a007-4d6f3e3b470b/communities/images/record_home_list_view_filter.png" alt="Filter icon"></span> to filter the list view or
                      remove filters. They can also click <span style="vertical-align:text-bottom;display:inline-block;"><img style="margin-bottom:0;" src="https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-experience-communities-264-0-0-production-enus/bf7df212-91a1-4fa3-a007-4d6f3e3b470b/communities/images/record_home_list_view_chart.png" alt="Charts icon"></span> to view related charts. </li>
                  </ul>
                </td>

              </tr>
              <tr class="">
                <td data-label="Property" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e75 ">
                  <samp class="parmname">Show list search</samp>
                  <sup>
                    <a href="https://help.salesforce.com/s/articleView?id=experience.rss_record_list_view.htm&amp;release=264.0.0&amp;type=5"><sup>1</sup></a>
                  </sup>
                </td>

                <td data-label="Details" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e78 ">Displays search field, scoped to the displayed list.
                  Enabled by default.</td>

              </tr>
              <tr class="">
                <td data-label="Property" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e75 ">
                  <samp class="parmname">Show refresh button</samp>
                </td>

                <td data-label="Details" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e78 ">Enabled by default.</td>

              </tr>
              <tr class="">
                <td data-label="Property" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e75 ">
                  <samp class="parmname">Show charts button</samp>
                </td>

                <td data-label="Details" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e78 ">Enabled by default.</td>

              </tr>
              <tr class="">
                <td data-label="Property" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e75 ">
                  <samp class="parmname">Show filter button</samp>
                </td>

                <td data-label="Details" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e78 ">Enabled by default.</td>

              </tr>
              <tr class="">
                <td data-label="Property" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e75 ">
                  <samp class="parmname">Show object name</samp>
                </td>

                <td data-label="Details" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e78 ">Enabled by default.</td>

              </tr>
              <tr class="">
                <td data-label="Property" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e75 ">
                  <samp class="parmname">Show image icon</samp>
                </td>

                <td data-label="Details" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e78 ">Enabled by default.</td>

              </tr>
              <tr class="">
                <td data-label="Property" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e75 ">
                  <samp class="parmname">Show display options</samp>
                  <sup>
                    <a href="https://help.salesforce.com/s/articleView?id=experience.rss_record_list_view.htm&amp;release=264.0.0&amp;type=5"><sup>1</sup></a>
                  </sup>
                </td>

                <td data-label="Details" class="slds-cell-wrap" style="vertical-align:top;" headers="d20503e78 ">Lets users view records in a table or Kanban format, or
                  restricts them to a single type of view. Default is
                  <strong class="uicontrol">Show All Options</strong>.
                </td>

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

![Example](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-experience-communities-264-0-0-production-enus/bf7df212-91a1-4fa3-a007-4d6f3e3b470b/images/icon_example.png)

Example Sample Record List component (Full layout):

![Record List component with all options called out](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-experience-communities-264-0-0-production-enus/bf7df212-91a1-4fa3-a007-4d6f3e3b470b/communities/images/record_home_list_view-allinone.png)

When all properties are enabled, site members can:

- Change the list view and pin it (1).
- Use search (2) to find items in long lists.
- Use list actions to accomplish list-related tasks, such as creating a record (3).
- Access list view controls (such as sharing settings), change how the list is displayed, view related charts, and filter the list view (4).
- Edit fields inline (5).

Sample Record List component (Compact layout):

![Record List component in compact layout](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-experience-communities-264-0-0-production-enus/bf7df212-91a1-4fa3-a007-4d6f3e3b470b/communities/images/record_home_list_view_compact.png)

Sample Record List component (Standard layout):

![Record List component using Standard view](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-experience-communities-264-0-0-production-enus/bf7df212-91a1-4fa3-a007-4d6f3e3b470b/communities/images/record_home_list_view-standard.png)

#### See Also

- [Which Components Can I Use with Each Aura Template?](https://help.salesforce.com/s/articleView?id=experience.rss_component_reference_table.htm&release=264.0.0&type=5 "Aura site templates, such as Customer Service and Partner Central, are each composed of pages, which in turn are made up of customizable components. Consult this table to find out which Aura template each component can be used in, and when the component became available.")
- [Objects Supported by Out-of-the-Box Components and Pages in Experience Builder Templates](https://help.salesforce.com/s/articleView?id=experience.networks_napili_supported_objects.htm&release=264.0.0&type=5 "Check out the list of all the objects supported by out-of-the-box components and pages in Experience Builder templates.")
- [Record List (LWR)](https://help.salesforce.com/s/articleView?id=experience.rss_record_list_lwr.htm&release=264.0.0&type=5 "The Record List component for LWR sites helps your site visitors easily view, search, and sort their accounts, cases, and other data. The component enhances security and user satisfaction by showing users only the data they’re permitted to view based on admin-defined access. With properties for component customization and styling—including support for custom CSS—the component helps you make sure that your visitors have a smooth and responsive experience across desktop, tablet, and mobile devices. The component offers a clean, professional data display that you can tailor to perfectly align with your brand and website design theme.")

1 Available for Full layout only and therefore unavailable when viewed on mobile devices.

2 Guest users can’t access filter or sort actions on any device.