top of page
Writer's pictureJonathan Stuckey

SharePoint - How to configure highlighted content webpart

Author: Jonathan Stuckey


A fundamental tool in the kitbag for publishing solution in SharePoint Online is the Highlighted Content webpart (HCWP). Pointing at local content is well covered online in Microsoft's articles and videos



In this article I'll do a quick run down on using the extended query options, to pull in existing information across site-collections.


Preparation is key

  • navigate to the site where the content is

  • copy the site path URL (e.g. https://organisation.sharepoint.com/sites/<resource_site>)

  • navigate to library

  • open settings > library settings

  • identify key column that will be used for filtering i.e. Function

  • click on column and find the internal column name

  • open site-settings

  • select Search Schema

  • under Managed properties enter internal column name (e.g. Function)

  • make note of the Refinable property returned which has this mapped e.g. RefinableString02

capture of SharePoint search schema managed properties list - filtered
Grab the Refinable property name, for use in HCWP

Now we have key information, we can configure the results in Highlighted Content webpart.


On target page

Once you have the key field internal name, and related Refinable reference, you can use this to identify content you want in the Highlighted Content web-part.

  • navigate to your page where will display information

  • edit the page

  • edit the HCWP

  • In the Content Source section - paste in the source URL

  • Select the site

  • Scroll down the panel

  • In Filter and Sort section, change the Filter to 'Managed Property'

  • In 'Find a managed property' drop-down type in 'Refinable'

  • Wait a couple of seconds...

  • Managed property name will now populate

  • Select our Refinable property (RefinableString02)

HCWP configuration panel showing managed properties
HCWP pulls through available Refiners from target
  • Now change the matching-criteria in box below, to 'Begins with'

  • In final box type in 'Health' - this is the label of the content we want to display

HCWP configuration with search-query criteria
Instant view of the results from target site

If content has been indexed, and the Refinable property picked-up the results (left in picture) will instantly change to show the desired content. If not, you may have to wait for the search crawl to complete.


Remember

HCWP is basically a search driven content roll-up. This means some times it can take a while for your content to show-up in the view. Be patient. SharePoint indexing isn't instantaneous - it can be anything from 15-minutes to 4-hours, depending upon the load on your tenancy.


Related articles



About the author: Jonathan Stuckey

3 views0 comments

Comments


bottom of page