Configuring bento searches is a multi-step approach that requires both bento pages and the custom bento areas of the Bento sub-tile in the Search Configuration tile of the dashboard.

Configuring Bento Searches

If your bento search will include the ability to search from an external source or provider via an integration, ensure the integration is configured as required in the Integrations tile of the Dashboard.

1. From the Dashboard, click Search Configuration
2. Click Bento, then click Custom Bentos
3. Click the Custom <provider> Bentos tile
   1. For example, for an EBSCO Discovery Service search, the tile would say Custom EDS Bentos
4. Click + Add Custom <procider> Bento
   1. Label, enter a name for the search
   2. Facet Filters
      1. Source Type
         1. Search Facets, enter a name for the search, example: magazines or books
         2. Click Search
         3. From the returned results, select the value(s) to search
      2. Content Provider
         1. Search Facets, enter a name for the search, example: magazines or books
         2. Click Search
         3. From the returned results, select the value(s) to search
      3. Subjects
         1. Search Facets, enter a name for the search, example: magazines or books
         2. Click Search
         3. From the returned results, select the value(s) to search
   3. Click Save

Create Bento Pages

1. From the Dashboard, click Search Configuration, then Bento
2. Click Bento Pages
3. Click Add New
4. Complete the fields in the window that opens
   1. Title - enter a title for the bento page
   2. Language - select the language
   3. Body - enter a small narrative explaining the bento page
   4. Update the Publishing workflow if needed
5. Click Save
   1. You will be returned to the list of Bento pages
6. Under the Operations column, click Edit beside the Bento page you just created
7. Click the Layout tab near the top of the screen
   1. You will be taken to a page similar to the Layout Builder for your Stacks site, here you can configure the sections and blocks that will display the bento search results
8. Click +Add section
   1. A window will appear on the right
      1. Select from the One column, Two column, or Three column layout options
         1. Modify the Column widths if needed
         2. Administrative label - add a label that will appear in the top left corner of the section when viewing the page in this layout viewer. This can be a benefit for other administrators to understand how the page was built 
      2. Click Add section
9. Click + Add Block
   1. A window will open on the right, under the Bento Block section, click Add a Bento Block
   2. Heading, give the block a name that best describes the type of search results, example: Magazines or Books
   3. Subheading, optional
   4. Bento Subtitle URL, optional
   5. Bento Type, select the search type from the drop-down
   6. Additional options
      1. Depending on the search type, additional configuration options may be displayed below, these could include: 
         1. Limit results
         2. Enable pagination (recommended when searches could return a large number of results)
         3. Results per page
         4. Filters

Note: If adding multiple Bento pages, users will select the desired page from a drop-down in the search field.