You can create more than one knowledge base widget within a project. For example, to maintain a separate widget for testing changes alongside your live production widget.
Settings that stay isolated per widget
- Widget name
- Styling (color, icon, position, welcome message, hide widget, hide most searched articles)
- Content access (workspace, language, category visibility)
- Custom links
- Domain restriction
NOTE
Changes made to any of the above settings on one widget do not affect any other widget in the project.
Setting shared across widgets
If JWT authentication is enabled, the client secret is shared across all JWT-enabled widgets and chatbots in the same project, regardless of which widget you regenerate it from.
Regenerating the client secret on one widget (including a test widget) will immediately break authentication on every other JWT-enabled widget in the project until their backend integrations are updated with the new secret.
If you're using a separate widget to test JWT-related changes, avoid regenerating the client secret unless you're ready to update all backend integrations tied to JWT-enabled widgets across the project at the same time.
For full JWT setup details, see Configuring JWT for the knowledge base widget.
FAQ
I made changes to my test widget and my live widget broke. Why?
Most widget settings (styling, content access, links, domain restriction) are isolated per widget and won't affect other widgets. The one exception is the JWT client secret, which is shared across all JWT-enabled widgets and chatbots in the project. If the client secret was regenerated on your test widget, it will also invalidate authentication on your live widget until the new secret is updated in its backend integration. See Using multiple widgets within a project for details.
The knowledge base widget is not loading on the knowledge base site. How can I fix this issue?
The knowledge base widget may not load on your knowledge base site if the API key is outdated. Updating the API key should resolve the issue and restore the widget functionality.