How to Set Up a Knowledge Base in Your Customer Portal
A knowledge base gives portal users articles, FAQs and how-to guides they can search and read, so they find answers without contacting your team. You show it in the portal with the Knowledge Base widget, which lists articles from your CRM. Searching articles is a standard portal feature.
Before you start
- You need access to Design → Page Builder in the admin portal.
- Have published knowledge articles in your CRM.
- Decide whether the knowledge base is for signed-in portal users only or for everyone. See How to Set Public and Login-Only Portal Pages.
- If you want to limit which articles portal users see, create a workflow first. See How to Apply Workflows to Portal Widgets.
Create the knowledge base page
Give the knowledge base its own page, so you can link to it from the portal menu.
- Go to Design → Page Builder and select Create.
- Enter the Page Title, Page URL Slug and Page Display Name, for example
Knowledge Baseandknowledge-base. - In Page Access, choose who can open the page.
- Choose a Page Layout, or select a template in Select Template.
- Select Next to open the page layout editor.
- Add a section and a grid for the widget.
For details on each page setting, see How to Create Pages in CRMJetty Portal.
Add the Knowledge Base widget
- In the widget panel, select Knowledge Base. The widget is added to the grid.
- Select the Settings icon on the widget to open its configuration panel.
- Fill in the settings in the tables below.
- Select Save.
- Select Publish to publish the page.




The widget goes live in the portal only after you publish the page.
Knowledge Base widget settings
General Configuration
| Setting | What to enter |
|---|---|
| Knowledge Base Title | The title portal users see above the articles, for example Help Center. |
| Records Per Page | How many articles show on each page of the list. |
| Select Role Type | The role type that controls access to the knowledge base. |
| Enable Workflow | Turn on to apply a workflow to the widget. |
| Select Workflow | The workflow that decides which articles load. Select a workflow when Enable Workflow is on. |




Knowledge Base Settings
| Setting | What to enter |
|---|---|
| HTML Class | One or more custom CSS classes to style the widget. |
| HTML ID | A unique ID for the widget, to target it with CSS or JavaScript. |
| Card View | Shows the articles as cards instead of a list. |
Tip: Some teams prefer articles in a grid, others in a list. Use Card View, a page template and your own CSS classes to present the knowledge base your way. See How to Add Custom HTML IDs and CSS Classes to Widgets.
To remove the widget from the page, select its Delete icon.
What portal users see
On the published page, portal users see the knowledge base title and a list of articles. They can search the articles and open one to read it.




To make the page easy to find, add it to the portal menu. See How to Create Portal Navigation Menus.
Use the knowledge base to reduce support cases
The Case Deflection widget suggests articles before a portal user creates a case. Set it up on your support page so portal users see matching answers first. See How to Set Up Case Deflection in Your Customer Portal.
Troubleshooting
The knowledge base shows no articles: Check that the articles are published in your CRM. If Enable Workflow is on, check that the selected workflow does not filter out all articles.
The knowledge base page does not appear in the portal: The page is still a draft. Publish it, then add it to a menu.
Related articles
- How to Set Up Case Deflection in Your Customer Portal
- How to Manage Support Cases in the Customer Portal
- How to Create Pages in CRMJetty Portal
- How to Apply Workflows to Portal Widgets
- How to Set Public and Login-Only Portal Pages