Sign in with Microsoft
Sign in or create an account.
Select a different account.
You have multiple accounts
Choose the account you want to sign in with.

When you add a modern page to a site, you can add and customize web parts, which are the building blocks of your page.

This article describes the List properties web part, which allows you to connect to a list web part on the same page and display specific properties of the list on your page dynamically. For more information on ways to connect web parts to show dynamic data, see Connect web parts in SharePoint.


  • Some functionality is introduced gradually to organizations that have opted in to the Targeted¬†Release program. This means that you may not yet see this feature or it may look different than what is described in the help articles.

  • The List properties web part is not available in SharePoint Server 2019.

Add the List properties web part

In the following example, a List web part (top) contains a list of Regional offices. When the user selects an item from the list, the List properties web part (bottom) displays only the Office name and Sales data.

Example of a list connected with a List properties web part

To do this:

  1. If you don't already have the list you want to connect to, create the list and add the columns (properties) you want to display on your page.

  2. Go to the page where you want to add the list connection.

  3. If your page is not already in edit mode, click Edit at the top right of the page.

    Hover your mouse above or below an existing web part and you'll see a line with a circled +, like this:

    Plus sign for adding web parts to a page

  4. Click +, and then select List from the list of web parts. Select the list you want to use.

  5. Add the List properties web part on the same page.

  6. On the List properties web part, click Edit web part Web part edit button on the left side.

  7. Click the ellipses (...) at the top right of the property pane, and then click Connect to source.

    Connect to source button
  8. Under Connect to source, select the list you want to use from the drop down list.

  9. Under Display, select what you want the user to see on your page. 

  10. Under Fields to display, select the check boxes next to the columns that you want to show values from.

    List properties web part pane
  11. Click Save as draft at the top of the page.

  12. Test your connection by selecting an item from the list you chose. You should see the value you specified in the List properties web part.

  13. When you're ready for your audience to see the page, click Publish at the top right of the page.

Need more help?

Want more options?

Explore subscription benefits, browse training courses, learn how to secure your device, and more.

Communities help you ask and answer questions, give feedback, and hear from experts with rich knowledge.

Was this information helpful?

What affected your experience?
By pressing submit, your feedback will be used to improve Microsoft products and services. Your IT admin will be able to collect this data. Privacy Statement.

Thank you for your feedback!