The Knowledge base widget must be installed on your website or application before readers can interact with it. Installation involves copying a JavaScript snippet from the widget settings and embedding it in your site's HTML — either via the Document360 Integrations panel or directly in your site's code.
When to install the widget
- Surface your documentation inside a SaaS application or product UI.
- Embed knowledge base search on a marketing or support website.
- Add the widget to your Document360 knowledge base site so readers can access it without leaving the documentation.
How to install the knowledge base widget
Install on your Document360 knowledge base site
- In the left navigation bar, navigate to Connections () and select Knowledge base widget.
To install an existing widget, skip steps 2–4. Hover over the desired widget and click the Copy script icon. The code snippet is copied.
- Click Add widget at the top-right corner and enter a name for the widget.
- In the Configure & connect tab, expand the Widget JavaScript accordion.
- Click Copy to copy the JavaScript code snippet.
If the widget has not been installed anywhere yet, you will see: "Installation Widget JavaScript code is not installed anywhere." The Installed domains dropdown shows domains where the widget has been detected.
- Navigate to Connections () > Integrations in the left navigation bar.
- Click Add in the Custom HTML tile.
- In the Add new integration panel, set the Insert code option to At the end of body (below
</body>). - Paste the copied code snippet into the code panel.
- Click Add. The widget is now installed on your knowledge base site.
The autosave option is available when navigating between Knowledge base widget tabs.
Install on an external website
- Log in to your Document360 portal.
- Navigate to Connections () in the left navigation bar.
- Hover over your desired widget and click the Copy script () icon.
- Open the HTML source of your external website.
- Paste the copied script just before the closing
</body>tag. - Save and publish your changes.
If you use a CMS such as WordPress, your developer can help add the script to the correct location.
Connected domains
After installation, verify which domains the widget is running on.
- Navigate to Connections () > Knowledge base widget.
- Hover over the widget and click () Edit.
- In the Configure & connect tab, expand the Connected domains accordion.
The Connected Domains field shows all domains where the widget script has been detected. It is read-only and auto-populated.
- The Connected Domains field is read-only and cannot be manually edited.
- If the field is empty, the widget has not yet been detected on any domain.
- To control which domains can load the widget, use the Widget security section.
Best practices
- Test the widget on a staging environment before deploying to production.
- After installation, verify the widget appears by loading your site and checking for the widget icon.
- Configure domain restriction after installation to prevent unauthorized embedding.
- If you need the widget on both your knowledge base site and an external product, use a separate widget for each so configurations remain independent.
FAQ
Can I configure multiple knowledge base widgets for a single domain?
On the Enterprise plan, you can configure multiple widgets on a single domain, but only one is recommended for optimal performance. On Professional or Business plans, you can purchase add-ons to enable multiple widgets.
Can I install the knowledge base widget on an external website?
Yes. Copy the widget script from Connections > Knowledge base widget > Copy script, then paste it before the closing </body> tag in your external site's HTML. The widget will function on any domain where the script is loaded, unless domain restriction is enabled.