In Focus Verticals web part (Atlas 5.0+)

The "In Focus Verticals" web part in Atlas can be added to a page and linked to an In Focus web part to provide the end user with some additional buttons on the UI that can be clicked to change the results being shown by overriding the In Focus web part configuration.

This could mean changing the Result Source, such as switching between Documents and News, or simply applying different sets of refiners or search terms via the Query.

Verticals are applied to the results when clicked, after which the user can still use the refiners or search box (if available on that page) to further filter the results.

In this article:

• Web Part Default Verticals
• Listing Page Default Verticals
• Choose the display style for Verticals
• Use a Query String to pre-select a Vertical
• Custom Verticals
  
  

Web Part Default Verticals

If you add this web part to a page, you get two default verticals; All and Recent changes. These are worded such that they can be applied to any content types.

The "All" vertical is configured as so:

• Result Source: "All Mixed Knowledge (Atlas)"
• Query: {searchTerms}

The "Recent changes" vertical is configured as so:

• Result Source: "Mixed Knowledge (Atlas)"
• Query: {searchTerms} LastModifiedTime >= "Last Week"

These are set up to work with a connected Search Box automatically, and any result source can be chosen to change the type of content being returned.

However this is just the default set, you can do much more with verticals by configuring your own custom ones. See below: Custom Verticals

Listing Page Default Verticals

The default verticals on Atlas Listing Pages are different to the defaults when adding the web part to a page. These are shown to the right of the search box above the Filters. These defaults verticals are All {Items} and Related {Items}, with the "Related" vertical filtering based on the page tags of the current page. {Items} will be replaced with the type of content, e.g. Documents or Events.

In this example, the All Documents vertical is the default which applies no additional refiners. The Related Documents vertical takes into account the metadata tags of the current Atlas workspace and only shows documents which match those tags. This does not restrict which workspace the documents can come from, only the tags they need to have.

Other Listing pages such as Knowledge and Events have the same defaults, and some Listing pages such as People do not have any default verticals applied.

Choose the display style for Verticals

You can choose between Button and Tab item styles for the Verticals in the configuration panel for the web part using the following setting:

Use a Query String to pre-select a Vertical

The default behaviour for verticals is that the first one (furthest left) is selected by default when the page is loaded. However, we can set this up to be controlled by a Query String in the URL.

Edit your Verticals web part, then in the first section (Settings) you can see the box "Default vertical query string parameter" - choose a Query String and type it here - we recommend just using "v" for simplicity, but you can use any keyword except "vertical" because this is reserved for the Atlas Search panel:

Now we can load a page with a specific vertical already selected by adding the query string replacing each space in the vertical name with a +:

v=recent+changes

So if your vertical is called "Recent changes" your URL might look like:

https://{company}.sharepoint.com/sites/{siteURL}/SitePages/page.aspx?q=query&v=recent+changes

So the q query string is used by the search box and the v query string is used by the verticals. You can now create links which load a specific vertical in that page.

Custom Verticals

The default verticals are intended as an example to be configured and are unlikely to meet your specific requirement, so you can configure your own to match against specific metadata values, your Atlas User Preferences, or just use verticals to avoid having multiple In Focus web parts making your page stretch down too far. This is considered advanced configuration for those who are familiar with Atlas.

To learn how to configure your own custom verticals, please see: Configure custom In Focus Verticals

If you still have questions or need assistance setting these up please contact your CSM or support team.