Add a list

[This topic is pre-release documentation and is subject to change.]

A list is a data-driven configuration used to render a list of records without the need for a developer to surface the grid in the portal. Lists use Dataverse views to display records on the portal.

A list displays data in a grid view on Power Pages sites. Lists on pages are created from Dataverse table views. Dataverse table views can be created by using the Data workspace or from model-driven apps created in Power Apps. You can use them on pages or with forms to build a complete web application.


We've created a series of tutorials and videos for you to learn to use Power Pages and how create a view and add a list to a page. For more information, go to Tutorial: Add a list to a page.

To add a list:

  1. Open the design studio to edit the content and components of the page.

  2. Select the page you want to edit.

  3. Select the section you want to add the list component to.

  4. Hover over any editable canvas area, and then select the List icon.

    The add component menu.

  5. You can choose either to create a new list or use an existing list.

    If you choose to create a new list, you'll need to enter the following criteria.

    The add a list to a page.

    List Description
    Choose a table The name of the table the views are loaded from.
    Select Dataverse views The view of the target table that will be rendered. To modify the columns within the view, you'll need to access the Data workspace.
    Name your copy of the selected list The name of the list.
    Data Description
    Create a new record Allows the user to create a new record. You'll need to select the target webpage, form, or URL that contains the new record.
    View details Allows the user to view details. You'll need to select the webpage, form, or URL that contains the details.
    Delete record Allows the user to delete the record.
    Settings Description
    Number of records per page Determines how many records will be displayed per page. If the table contains more records, navigation controls will appear for the user to view the next or previous set of records.
    Enable search in list Turns on the search feature for the list.


    You'll need to enable table permissions to ensure that users will be able to view the data on the lists.

  6. You can select the ellipsis (...) to duplicate the list, move it up or down within the section, or delete it.

See also