You can configure content access in your knowledge base widget even when JWT is enabled for the widget. This gives you more flexibility in controlling what your end users can see.
How to configure content access
- Navigate to Connections () > Knowledge base widget in the left navigation bar.
- Hover over the desired widget and click the Edit () icon.
- In the Configure & connect tab, expand the Content access section.
- The filter levels available are:
- Project
- Workspace
- Category
- Choose the desired workspaces, languages, and categories to display in the widget.
- Click Done, then click Save to apply the changes.
Validating reader group content permissions
- When a reader logs in, the system will validate whether their reader group permissions match the widget's content access filters. Only the intersecting permissions between the widget-level settings and the reader group settings will be considered for validation.
- This ensures that users see only the articles they are authorized for, in both widget-level and reader group permissions.
- The same validation is applied when readers click internal links that target any article or category links inside the widget. The widget checks the configured content access filters, workspace scope, and reader group permissions before loading the destination content. If the linked content falls outside the allowed scope, the widget displays a restricted access state instead of rendering the article.
CAUTION
Changes made to content access will directly impact your URL mapping.If you modify the filter settings of the widget, the existing URL mapping may be removed, leading to broken links.
Example 1:
You have set the filter widget content at the Project level and configured a URL mapping that includes a list of articles from Category A in Workspace V1. If you update the filter settings to show only Categories B and C in the same workspace, the previous URL mapping becomes invalid—because the originally mapped articles from Category A are no longer available in the widget.You can only configure URL mappings using articles included in the current Filter widget content.
Example 2:
If the widget is filtered to display content only from Workspace V1, you cannot create a URL mapping for an article located in Workspace V2.
FAQ
Why are some categories missing from the knowledge base widget?
This issue may occur if category-level access has not been properly configured for the widget. To ensure your categories are visible in the widget:
Verify that the user or reader has permission to view the specific categories/articles in the knowledge base widget.
Check whether category-level access is configured for the widget. If it is, you need to manually add the desired category in the content access section during widget configuration.
To add the category to the widget:
Navigate to Connections () > Knowledge base widget in the knowledge base portal.
Hover over the desired widget and click the Edit () icon.
In the Configuration & connect tab, expand the Content access accordion.
Select Category and choose the desired category to appear in the widget.
Click Save to apply the changes.
Why does an article link open inside the widget instead of a new tab?
The knowledge base widget determines link behavior based on the destination workspace type and access eligibility.
The Open in a new tab setting configured in the editor is not supported in the widget. Internal links within the same domain always open inside the widget, regardless of the selected setting.
Articles in standard workspaces open inside the widget.
Articles in other standard workspaces also open inside the widget when they are included in the widget's content access configuration.
API documentation links always open in a new browser tab.
External domain links always open in a new browser tab.
If the destination content is restricted, the widget displays a restricted access state.
If the destination cannot be resolved, the widget displays a fallback state.
Why is an internal article link showing restricted access inside the widget?
This happens when the linked article is outside the widget's configured content access scope or the reader does not have permission through their assigned reader group.
Verify that:
The destination workspace is included in the widget configuration.
The linked category is within the allowed filter scope.
The reader has access through the assigned reader group.
If the destination content is outside the allowed scope, the widget intentionally displays a restricted access state.