Contact Us

Exhibits Documentation A guide to building exhibits using Spotlight


The Search settings determine how several search-related controls are presented to exhibit visitors.

Options tab

The Display search box option enables you to control whether your exhibit uses the default behavior of displaying a search box in the exhibit site menu bar.

You might choose to turn off the Display search box option if your exhibit has very few items (i.e., search is of limited utility to your users) or if you want to offer a simpler or more directed exhibit experience to your users. For example, we've turned off the Display search box option in this exhibit because this exhibit is primarily focused on the pages (i.e., the Strategy and Tips and Reference sections) rather than the exhibit items. Because only exhibit items are searchable, the search box has limited utility in this exhibit.

If you choose to turn off the Display search box option you can still include browse categories (named saved searches) in your exhibit, but if you want to save a search that is constructed using search terms, you will need to turn the Display search box option on temporarily so that you can access the search box to perform searches that you can then save to create new browse categories.

Screen Shot 2019-06-13 at 5.13.47 PM.png

Facets tab

Screen Shot 2019-06-13 at 5.15.41 PM.png

By default, a sidebar containing search facets is displayed on the Home page and search result pages of your exhibit website. The Facets tab enables you to control which facets to display in the sidebar, the order in which they are shown, and the labels that are used for each. Uncheck a facet to hide it from the sidebar, click a facet field name to edit its display label, and drag and drop facets to change their order in the sidebar.

Regarding the use of custom metadata fields as facets, only custom fields created using the controlled vocabulary option (not the free text option) can be selected as facets. However, due to some issues with this feature, we recommend you use it with caution at this time.

The video below shows how to perform the tasks described above.

To the right of each facet, you will see a notation of how many items are included in that facet and how many unique values that facet contains. Hovering your mouse over the "i" icon to the right of this information cause a bubble to pop up that shows you exactly what the unique values are for that field, as shown in the image below. This information can be useful in helping you decide whether to leave a facet on or turn it off; facets containing only a small percentage of your items or containing one or very few unique values may not be useful to your exhibit visitors.

Screen Shot 2019-06-03 at 3.27.29 PM.png

You can choose whether to have your facets sorted by Frequency (most frequently used value at the top of the list and least frequently used value at the bottom of the list) or Value (alphabetical, numerical, or date order). To the far right of each facet, you'll see the word Options and an arrow. Click on either of these to expand the facet information and choose whether you'd like that facet sorted by Frequency or Value. Don't forget to scroll to the bottom of the page and click Save changes.

Screen Shot 2019-06-03 at 3.27.46 PM.png

To hide the facet sidebar from the Home page, edit the Home page, select the Options tab, and uncheck the Show sidebar option. Click Save changes to save the update and leave edit mode. The video below shows how to perform these tasks.

Results tab

Search result pages are displayed in response to a search performed by the user or when the user selects a browse category. The Results tab enables you to control several aspects of the search results pages.

By default, all result page types (different page layouts of the result items) are available to the user. However, you can hide one or more page types by deselecting the Result page types checkbox associated with a page type. You might, for example, want to hide all result page types except Gallery to emphasize the visual aspect of your exhibit. Or, if you have a text-heavy exhibit, the List view may be the best choice for your content.

By default, 10 items are displayed on each page of the search results. To show more items per page by default (the user can always select a different option from the results page), choose one of the other Default per page options.

Sort fields

The Sort fields section of the Results tab shows a list of metadata fields that are available to end-users for sorting search result items. You can uncheck fields to hide them from the sort dropdown menu, click a field title to change its display label, and drag and drop fields to change their order in the menu. (Feature not currently available for Project Surfliner Starlight sites.)