Overview
Component name: Search Results
Authors who can use: Sapient to initially configure; any to edit
Templates/page types that can use component: varies by page
- Search Results: appears by default
- Agency Content Page: optional; add if needed
Required or optional: varies by page; see above
Authoring Fields
Adding the Search Results component to the page
Please contact Sapient before adding a Search Results component to ensure it is configured correctly.
- Search Hub pathfinder field: Enter a link to the Search Hub configuration.
- Facets dropdown: Click “Add” to add facets to the component. If none are added, none will display.
- Facets are typically configured with tags on the individual search results (ex. the Services Search Hub has facets for Agency, Audience, Service Category, Service Type, and Life Event; users can filter on the tags to narrow down Service results). There is no limit to the number of facets that can be added.
- Enable Time Frame checkbox: Check off to add the time frame authoring options. Default unchecked.
- Select Start./End Date dropdown: Select whether the time frame filter displays start date or end date. Default start date.
- Enable Date Range checkbox: Check off to allow users to select a start date and end date. Results will fall between the selected dates.
- Time frame fields
- Time Frame Label field: Add a label for the time frame. Ex. add "Next two years" to indicate that results show only for the next two years of events.
- Unit of Time dropdown: Select a unit of time. Results will only display within the selected unit. Ex. select "Year" for the "Next two years" example.
- Period of Time dropdown: Select Past or Future. Results will only show accordingly. Ex. select "Future" for the "Next two years" example.
- Time Span number selector: Select time span for the unit of time selected above. Ex. enter "2" for the "Next two years" example.
- Sort Options: If no sort options are added, results will automatically sort by Relevance.
- Primary sort dropdown: Add a sort option. This will be the default sort. This should usually be Relevance, unless another option should be the default (ex. Event Date for a calendar Search Hub).
- Secondary sort dropdown: Add a secondary sort option (ex. Alphabetical). Users may choose to switch to this sort.
- Display Sort and Filter by default checkbox: Check off whether the Sort and Filter options should automatically display on the page, without user needing to click and open (relevant for Agency Content Page template). Default unchecked.
- Enable Per Page Navigation checkbox: Check off to give users the option to select number of results per page, and to click through pages of results. Uncheck to display 25 results, with a "Load More Results" button to display the next 25. Default unchecked.
- Download Search Results Details
- Enable Download CSV checkbox: Check off to give users the option to download search results. Default unchecked.
- Download CSV Button Label field: Add a label to display on the download button.
- Coveo and CSV Fields field: Add Coveo and CSV fields separated by a comma. A sample is provided.
- Max Number of Items number selector: Add a value between 100-5000.
- Hide Sections checkboxes: Select which features of the Search Results component should be hidden, if any. Default unchecked.
- “Hide Labels” refers to the Tag pills displayed on the bottom of Search Result Cards. Tags will still apply through filtering, but will not display visually.
Accessibility
- There are no specific accessibility notes for the Search Results component.
Other tips
- Search Results for pages and documents are driven by the tags given to pages and assets in the Page Properties/Asset Properties. They are not manually authored. Reference the Page Cards guide and Document Cards guide for more info.
- Location-based Search Results are used to show results about specific counties/offices/districts. They are authored with Location Card Content Fragments. There are both Address and Text variations, for Location Cards with a specific address vs. with general geographic-based information. Reference the Location Cards - Text and Address guide for more info.
- Event-based Search Results are used to show upcoming or past events. They are authored with Event Card Content Fragments. Reference the Event Cards user guide for more info.
- If the Search Results component is added to a page with Side Navigation, the Sort & Filter pane displays on the right. When clicked, it will be an overlay on top of the component.
- On pages without Side Navigation, the Sort & Filter pane displays on the left. It is visible on default.
- To pre-filter a Search Hub:
- Go to the parent Search Hub that should be broken up.
- Filter the results as needed.
- Copy the URL.
- Navigate to the page that requires a CTA in the authoring environment. Link to the copied URL.
- Publish the page.
- The CTA will take users to the filtered Search Hub.