Widget configuration & installation

You are currently viewing a topic category type with description subcategory display type.

Widget Settings section

Widget Admin Settings

Widget Customize Text section

In Settings > Widget, the Customize Text section allows you to change a variety of text fields:

  • The Knowledge, Recommended, and Contact tab labels
  • The header text displayed in the Knowledge and Recommended tabs
  • The Open in full site and Scroll to top actions in the footer
  • The search bar placeholder and the header text displayed above Quick Search and Full Search results
  • Add a custom footer that will display below the open in full site and scroll to top footer
If you make changes to these settings, it may take up to an hour to see them in your browser due to caching. You can bypass the caching by doing a hard refresh.

If you want to change any of this text, check out the screenshots and descriptions below so you know you're changing the right field(s)!

Screenshot of Widget Settings Customized Text fields, numbered 1-11 beginning with Knowledge TabCustomized Text options

Screenshots of each widget tab with numbered callouts linking these fields to the previous screenshot's fieldsWidget tabs with matching Customize Text numbering

  1. Knowledge Tab: Text entered here will change the label for the Knowledge Tab, the first tab in the widget. This tab lets your readers browse and navigate your knowledge base. All articles clicked on in other tabs will open here, too.
  2. Recommended Tab: Text entered here will change the label for the Recommended Tab, the second tab in the widget. If you are using Contextual Help and Pages to Recommend On, the recommended articles for the current page display here.
  3. Contact Tab: Text entered here will change the label for the Contact Tab, the third tab in the widget. (This tab only displays if you are using the Contact Form in your knowledge base.)
  4. Open in Site: All three widget tabs include a footer which displays an Open in Site link. Clicking this link will open your full knowledge base in a separate tab, opened to the page currently displayed in the widget. (For the Recommended tab, Open in Site will take readers to your knowledge base's homepage.)
  5. Scroll to Top: All three widget tabs include a footer which displays a Scroll to Top link. This link is shown on non-touch devices so that if someone is scrolling through a lengthy article in the widget, they can quickly jump back to the top of the article.
  6. Knowledge Header: Text entered here appears at the top of the Knowledge Tab.
  7. Search Bar Placeholder: Text entered here is displayed in the search bar when it's empty. The search bar appears on the Knowledge and Recommended tabs.
  8. Recommended Header: Text entered here appears at the top of the Recommended Tab.
    Two screenshots showing search terms entered in widget; numbered callouts match the text listed belowQuick search, full search, and custom footer
  9. Quick Search Header: Text entered here displays at the top of the search results as someone types into the search bar.
  10. Full Search Header: Text entered here displays at the top of search results once someone hits enter or completes a full search.
  11. Custom Footer Content: You can insert your own custom footer, which will appear below the Open in Site and Scroll to Top footer. Text entered here will display there.

Widget Contact Form section

Custom Widget Styles

Custom Widget Javascript

Add spam protection to Widget 2.0 Contact Tab

Open widget to a specific article or category

Use Widget 2.0 for Contextual Help: Recommend on Pages

Hide one of the Widget 2.0 tabs

Widget 2.0 installation