Use the Highlighted content web part

Use the Highlighted content web part

When you add a modern page to a site, you add and customize web parts, which are the building blocks of your page. This article describes the Highlighted content web part.

Use this web part to dynamically display content from a document library, a site, a site collection, or all sites. By default, this web part shows your most recent documents. If you don't have any documents or pages on your site, you'll first have to create or upload them.

Example of highlighted content on a page

How does it work?

  1. Add the Highlighted content web part: Start with adding the web part to your page.

  2. Choose content: Choose the source location (such as a site or document library) and type of content to show (such as documents or pages).

  3. Filter and sort: Set filters to narrow down the content to show (such as documents modified by the current user) and a sort order.

  4. Select a layout: Choose between Cards, List, Carousel, or Filmstrip layouts.

Add the Highlighted content web part to a page

  1. If you're not in edit mode already, click Edit at the top right of the page.

  2. Hover your mouse above or below an existing web part or under the title region, click Circled plus sign used to add a modern web part to a page , and then select the Highlighted content web part.

    Once the web part is on the page, you can change the title by typing over the default title Most recent documents.

  3. Click the edit button Web part edit button and select your options.

Choose the content

Once you have added the web part and you see the web part property pane, do the following:

Highlighted content web part tool pane
  1. On SharePoint Online, in the Source dropdown, select where you want to show content from: This site, A document library on this site, This site collection, The page library on this site, Select sites. or All sites. If your site is connected to a hub site, you will also have an option to select All sites in the hub.

    When you click Select sites, you can search for the site you want to add, or select one or more sites from Frequent sites, or Recent sites.

    Select sites

    For SharePoint Server 2019, your choices are This site, A document library on this site, This site collection, and All sites.

    Note: If you plan on using multiple filters, see how they work together in the Using multiple filters section below.

  2. In the Type dropdown, select the type of content you want to show. The type of content available will depend on your source.

    If you want to show additional content types, click + Add content type.

Filter and sort

Once you have selected your content source and type, you can set filter and sort options to narrow down and organize the content.

Filter and sort
  1. In the Filter dropdown, select what you want to filter by, and then enter the specific details for the filter. The filters available will depend on the content type.

    • Title includes the words Enter the search words for the titles you want to find

    • Content includes the words Enter the search words for the content you want to find

    • Recently added Enter the time period since an item was added (such as Today, Yesterday, Earlier this week, and so on).

    • Recently changed Enter the time period since an item was changed (such as Today, Yesterday, Earlier this week, and so on).

    • Created by Enter a user name if you choose Selected user. Otherwise, use Current user, which will filter for items created by whoever is viewing the page at the time.

    • Modified by Enter a user name if you choose Selected user. Otherwise, use Current user, which will filter for items created by whoever is viewing the page at the time.

    • Managed property This option is available for all Source options except Document library. Managed properties can be built-in or custom, but must be searchable. Enter a word to narrow down the list of searchable properties, select a property from the dropdown, and enter your criteria.

      For general information on managed properties, see Managed properties and search. For a list of available properties, see Overview of crawled and managed properties.

  2. In the Sort by dropdown, choose your option. The default is Most recent.

Using multiple filters

Using multiple filters is a great way to narrow down your content results. When you use multiple filters, your results will be based on OR operations for filters of the same type, and AND operations for filters of different types. For example, if you select two filters: Title includes the word Status, and Title includes the word Project, your result will be all files that have Titles containing the word Status or Project. On the other hand, if you select filters of different types, your results will be based on AND operations. For example, if you select two filters: Title includes the word Status, and Created by megan, then you will get only those files that have Status in the Title and that are also created by megan. When you select multiple filters of different types, your results will be based on grouped OR operations for all filters of the same type, and AND operations for filters of different types, as shown here:

Choose the layout

Choose Cards, List, Filmstrip, or in SharePoint Online, Carousel,, then enter the number of items you'd like to show and whether to show the web part when no items are found.

Layout

Note: If you’re familiar with earlier versions of SharePoint, Highlighted content is the newer, simplified version of the Content Search web part.

Expand your Office skills
Explore training
Get new features first
Join Office Insiders

Was this information helpful?

Thank you for your feedback!

Thank you for your feedback! It sounds like it might be helpful to connect you to one of our Office support agents.

×