Search Knowledge Base by Keyword

This KB documentation is using Advanced Search, Links Editor and Elegant Layouts add-ons.

Print

5. Change KB Permalinks, URL, and Article Slug

Created OnAugust 23, 2020
Updated OnMarch 2, 2025
By:Dennis
5 out Of 5 Stars

2 ratings

5 Stars 100%
4 Stars 0%
3 Stars 0%
2 Stars 0%
1 Stars 0%
Views3199

The Echo Knowledge Base pages are illustrated in the diagram below (click to zoom):

Common KB URL updates:

a) I want to add my Knowledge Base to:

b) I want to change the URL of my Knowledge Base - read instructions

c) I need to update the KB Articles URL so it matches the KB Main Page URL - read instructions 

OPTION 1: Change URL of the KB Main Page

Copy the URL link to this section to share

If you have an existing page that contains KB blocks or KB shortcode and just want to update the URL, follow these steps:

Step

Find the Page with KB Blocks or KB Shortcode

How to find the page:

  1. Go to the the KB configurations
  2. Select the KB URLs Tab
  3. Click on the Change title button to edit the page
 

Other ways to find the page:

  • Go to admin > pages and find the page
  • Open the KB Main Page on the frontend and in the admin bar click Edit Page
Click on image to zoom in
Step

Change the KB Main Page Slug

In this step we are updating the current slug from "knowledge-base" to "support"

Go to the right sidebar and update the Permalink, then save.

Click on image to zoom in
Step

Update Articles URL

After updating the URL for your KB Main Page in step 2, you also need to update the Article Pages URL:

  1. Go to admin ⮞ knowledge base ⮞ configuration.
  2. Select the KB URLs Tab.
  3. This URL is your old slug  ( knowledge-base ) and the articles are still using it.
  4. This is the new URL  ( support ) based on the slug you updated in the previous step.
  5. Select the new Slug for the article URLs and hit the apply button.
 

Here you can see the old article slug versus the new article slug. Knowledge-base  versus  support 

Click on image to zoom in
Changes are not visible

If you do not see changes on the front end, please try the following:

  • Clear your website cache and browser cache.
  • Go to Admin ⮞  Permalinks ⮞  Click on Save Changes.

OPTION 2: Add Knowledge Base to an Existing Page

Copy the URL link to this section to share

If you already have an existing page on which you want to show your Knowledge Base, follow these steps:

Step

Add Block or Shortcode to Existing Page

Find the page where you want to add the Knowledge Base. This page will serve as your dedicated KB main page.

Add one of the following to the page:

Keep a personal note of the page slug.

Step

Update the Articles URL

Once you added the KB Blocks or KB Shortcode to a new page, you need to update your article URLs to match it:

  1. Go to admin ⮞ knowledge base ⮞ configuration.
  2. Select KB URLs tab.
  3. Choose the new page URL. In this example, the "support" is the correct URL.
  4. Click Apply.
Click on image to zoom in
Step

Remove the Old Main Page

Remove the old KB Main Page:

  1. Go to admin ⮞ knowledge base ⮞ configuration.
  2. Select the KB URLs tab.
  3. Here you can see we detected the old page, click on the Edit page button. 
 

You have two options:
    a) Remove the shortcode/blocks and update the page.
    b) Delete the page entirely.

What happens if you keep both? 
The second main page will still work, but the article URLs will be different since it's using the primary one you used in step 2.

Changes are not visible

If you do not see changes on the front end, please try the following:

  • Clear your website cache and browser cache.
  • Go to Admin ⮞  Permalinks ⮞  Click on Save Changes.

OPTION 3: Create a New Page with Knowledge Base

Copy the URL link to this section to share

Go to admin ⮞ Pages ⮞ Add New and enter your page title. Then follow steps listed in the Option 2 above and ignore Step 3.

OPTION 4: Update KB Articles to match the KB Main Page URL

Copy the URL link to this section to share

Follow these steps:

  1. Go to admin ⮞ knowledge base ⮞ configuration
  2. Select the KB URLs tab.
  3. Scroll down to "Knowledge Base URL" section at the bottom.
  4. Choose the URL that matches your KB URL of the Main Page.
  5. Save your settings.
Click to zoom

OPTION 5: Set Your Knowledge Base as the Home Page

Copy the URL link to this section to share

To set the Knowledge Base on your Home Page, follow these steps:

  1. 1. Go to admin ⮞ Settings ⮞ Reading page.
  2. 2. Choose a Static page option.
  3. 3. Choose the page where the knowledge base is located.
  4. 4. Save your settings.
Click to zoom

Note: The URL of articles and categories will remain unchanged, retaining the KB Main Page slug.

Advanced URL Settings

Copy the URL link to this section to share

In some cases, setting the category slug and tag slug may be required. The following screen shows where you can configure these slugs.

Changing Slugs Will Affect Your Website

Do not make changes unless you need to define a different category or tag slug for your category/tag archive pages.

All links containing the category and tag slugs will be affected.

Was this article helpful?
5 out Of 5 Stars

2 ratings

5 Stars 100%
4 Stars 0%
3 Stars 0%
2 Stars 0%
1 Stars 0%
5
How can we improve this article?
Please submit the reason for your vote so that we can improve the article.
Need help?
Tags:
Table of Contents

Copyright © 2024 Echo Plugins. All Rights Reserved.