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.

Highlighted content

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 toolbox, do the following:

Highlighted content web part tool pane
  1. In the Source dropdown, select where you want to show content from: This site, This site collection, A document library on this site, or All sites.

  2. In the Type dropdown, select the type of content you want to show. You can choose one of the following:

    • Documents (when you choose Documents, you can also choose a Document type, such as Word, Excel, PowerPoint, and so on). If you want to show more than one type of document, click + Add document type.

    • Pages

    • News

    • Videos

    • Images

    • Events

    • Issues

    • Tasks

    • Links

    • Contacts

    • All

    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:

    • 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.

    • Column name This option is available only when you have a Document library selected in the Source dropdown. Enter a word to narrow down the list of column names, select a property from the dropdown, and enter your criteria.

      Using tokens For properties with user values, such as Author, you can enter the [ME] token to display only your documents. For properties with values related to dates, such as Modified, you can enter the [TODAY] token to display only documents modified today. Additionally, you can show documents before or after today by using [TODAY]+/-. For example, to show only documents that were modified yesterday, you would use [TODAY]-1. Be sure to not use any spaces in this syntax.

      Filter for a document library using Column name

    • 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.

      Using tokens For properties with user values, such as CreatedBy or ModifiedBy, you can enter the [ME] token to display only your documents. For properties with values related to dates, such as ContentModifiedTime, you can enter the [TODAY] token to display only documents modified today. Additionally, you can show documents before or after today by using [TODAY]+/-. For example, to show only items that were modified yesterday, you would use [TODAY]-1. Be sure to not use any spaces in this syntax.

      Highlighted content with managed property filter

      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.

Choose the layout

Choose Cards, List, Carousel, or Filmstrip, 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.

Connect with an expert
Contact us
Expand your skills
Explore training

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.

×