Section search

Section search needs to be enabled for your site before it can be used

Contact the Mosaic team to ask for section search to be enabled.

To setup Section search, the following components need to be in place:

A 'Search' taxonomy — including at least one taxonomy term. The search taxonomy term(s) will need to be applied to each page you want to include in section search queries. Find out about the search taxonomy and adding terms
A section search scope. This is one of the search scope types. Create a section search scope
A section search widget. This displays a search bar on the page so that visitors can run their search queries. Add a section search widget

Search taxonomy and adding a term to a pages

Once Section search is enabled for your site, the 'Search' taxonomy will be listed on the Taxonomy Administration screen as one of your site's taxonomies. It is an 'uncontrolled' taxonomy, which means terms can be added to the taxonomy either: via the Taxonomy Administration screen; or in the page editing screen's Details tab (for each page). See the documentation about adding taxonomy terms.

The taxonomy needs to have at least one term and the term will need to be added to all pages you want to include in the section search queries.

To add the term to a page:

Go to the page's editing screen
Go to the Details tab > 'Taxonomies' section
Scroll down to the 'Search taxonomy' input field
Start typing the name of the taxonomy term you want to add to the site. If the term has already been added to the taxonomy, the autocomplete will display the term in a dropdown list for you to pick (see example below)

Adding a search taxonomy term to a page
Select the term and save the page edits (as Draft/Needs review/Publish now)

Create a section search scope

Make sure there are terms in your site's 'Search' taxonomy — see the section above
Go to Site Settings > Search tab > Search scopes section > click the link to 'manage your Search scopes'
Select the search scope type: 'Section search'

Creating a section search scope
Select the search taxonomy term that you added to your pages [see 1 in the example above]
Provide text for the search scope label [2 in the example above]. If you set your section search scope to appear on the search results page, the label will be displayed in the tab for the search scope
Click 'Save'
An entry for the section search will appear in the search scope summary table

Add a section search widget

Go to the page editing screen > one of the page Region tabs
Select 'Section search' from the list of widget's
Click 'Add another widget'
On the widget editing screen, select the section search scope from the dropdown list [1 in the example below]

Select the section search scope from the dropdown list
Click 'Save'
The section search input will be visible on the page and can be used by visitors to run search queries (see section search example below)

Example of section search results