CRMJettyBack to crmjetty.comContact us
Menu
Docs / Guides

CRMJetty Portal

Works with
Docs / Dynamics 365

Dynamics 365 Customer Portalv6.3.0

Docs / Salesforce

Salesforce Customer Portalv6.3.0

Docs / Business Central

Business Central Portal

Guides / Support and knowledge base

How to Set Up a Knowledge Base in Your Customer Portal

6 min readUpdated
Short answerCreate a page in Design → Page Builder, add the Knowledge Base widget to a grid, open its settings, enter the Knowledge Base Title, Records Per Page and Select Role Type, optionally select a workflow, then select Save and publish the page.

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

Create the knowledge base page

Give the knowledge base its own page, so you can link to it from the portal menu.

  1. Go to Design → Page Builder and select Create.
  2. Enter the Page Title, Page URL Slug and Page Display Name, for example Knowledge Base and knowledge-base.
  3. In Page Access, choose who can open the page.
  4. Choose a Page Layout, or select a template in Select Template.
  5. Select Next to open the page layout editor.
  6. 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

  1. In the widget panel, select Knowledge Base. The widget is added to the grid.
  2. Select the Settings icon on the widget to open its configuration panel.
  3. Fill in the settings in the tables below.
  4. Select Save.
  5. Select Publish to publish the page.
Page Builder with the Knowledge Base widget on a grid and its configuration panel open
Page Builder with the Knowledge Base widget on a grid and its configuration panel open
Page Builder with the Knowledge Base widget on a grid and its configuration panel open
Page Builder with the Knowledge Base widget on a grid and its configuration panel open

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 widget General Configuration with Knowledge Base Title, Records Per Page, Select Role Type and Enable Workflow
Knowledge Base widget General Configuration with Knowledge Base Title, Records Per Page, Select Role Type and Enable Workflow
Knowledge Base widget General Configuration with Knowledge Base Title, Records Per Page, Select Role Type and Enable Workflow
Knowledge Base widget General Configuration with Knowledge Base Title, Records Per Page, Select Role Type and Enable Workflow

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.

Portal knowledge base page showing the title, the search box and a list of articles
Portal knowledge base page showing the title, the search box and a list of articles
Portal knowledge base page showing the title, the search box and a list of articles
Portal knowledge base page showing the title, the search box and a list of articles

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.

Did this solve it?No, contact support