Search Box widget

Use the Search Box widget to provide members with a more focused search experience. Unlike the search box found on the Userbar, you can configure the Search Box widget during its setup to pre-filter a member's search to specific locations and content types. 

Similar to other search boxes in your digital workplace, the Search Box widget displays quick search results as you type your query and more extensive results when you press Enter after typing your query.

The search box widget on a page.

Sections in this article:

Considerations

  • Access: Users will only see search results to which they have at least Read access.

Who can do this?

  • Enterprise administrators
  • Workplace administrators
  • Space administrators
  • Members of the digital workplace with Edit or Full access

Set up

Follow these steps to set up this widget:

  1. Place a  Search Box widget on a page, space, or dashboard. For more information, see Place and set up a widget. 
  2. Select the placed widget's Edit button.
  3. Review and make changes to the settings on the Options, Layout, and Appearance tabs. You can find details about the widget's settings in the Settings section below.
  4. In the widget editor, select Update to apply your changes or Cancel to discard them.  
  5. At the bottom of your page, space, or dashboard, select Publish or Save as Draft to save your changes.

Settings

Setting Description
Title Enter a title for the widget. The title appears as a heading above the widget's contents. You should use the title to provide context to the widget and better structure a page's content by clearly denoting different sections.

When entering a title, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should select  Translation and enter a title for each supported language.  

This field can contain a maximum of 140 characters.
Description

Enter a description for the widget. The description appears between the title and the widget's contents. You can use this text to provide users with information about the widget.

When entering a description, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should select  Translation and enter a description for each supported language.
Search Box hint text Select a hint text to be displayed in the search text box when there is no query. Options include: 
  • Default text: Default text will vary depending on Search in and Filter by selections. This text automatically displays in a user's selected language.
  • Custom Text: Custom text allows you to enter a text string to display. If your digital workplace supports multiple languages, you should select  Translation and enter a description for each supported language.
Search in

Select a location where the search box looks for results:

  • Current Page: Searches content nested under the page and HTML Content widget on the page.
  • All of the community
  • A specific space
Filter by

Select which content type to include results for:

  • No Filter: All content types are returned)
  • Blogs
  • Calendar
  • Pages
  • People: Searches the entire workplace regardless of Search in setting.
  • Documents
  • Forums
  • Wikis
  • Spaces: Restricts Search in options to Current Page and All of the Community.
  • Microblogs: Only available if Search in is set to All of the community.
Options tab
Setting Description
Class Enter CSS class selectors to provide additional styling to the widget. For more information, see Applying custom CSS to widgets.
Height Select the height of the widget. Options include:
  • Auto: The leftmost slider position. The widget's height will increase and decrease to contain what it displays.
  • Fixed: Select a fixed height between 50px and 600px in increments of 50px. A vertical scrollbar will appear on the widget if the content exceeds this fixed value.
Appearance tab

Note

Your digital workplace's theme overwrites many of the settings on the Appearance tab. However, the settings listed above are usable.