How to Enable Built-In Knowledge Base SEO

SoftwareRoad Knowledge Base includes built-in SEO features for your knowledge base articles and category pages.

These settings help search engines understand your documentation and control how article titles and descriptions may appear in search results.

You can use the built-in SEO tools without installing a separate SEO plugin.

Open the SEO settings

To find the built-in SEO options:

1. Sign in to your WordPress dashboard.
2. Open Knowledge Base > Settings.
3. Select the Privacy & SEO tab.
4. Find the Knowledge Base SEO section.
5. Enable the SEO features you want to use.
6. Select Save Changes.

Open one of your public articles afterwards and check that the page still loads correctly.

What the built-in SEO features do

Depending on the page being viewed, SoftwareRoad Knowledge Base can add useful search engine information such as:

• SEO page titles
• Meta descriptions
• Canonical URLs
• Article structured data
• Breadcrumb structured data
• Category page information
• Noindex rules for unlisted content
• Noindex rules when licensed content is unavailable

Most of this information is added behind the scenes and is not shown inside the article itself.

Enable built-in SEO

Find the option that enables SoftwareRoad Knowledge Base SEO and switch it on.

After saving the settings, the plugin can begin adding SEO information to published knowledge base articles and categories.

This does not change your article content or public URLs.

SEO titles

The SEO title is the page title search engines may use in their results.

By default, SoftwareRoad Knowledge Base can use information such as:

• The article title
• The category name
• Your website name

For example:

How to Activate SoftwareRoad Knowledge Base | SoftwareRoad

A clear SEO title helps visitors understand what the page covers before opening it.

Write clear article titles

Your normal knowledge base article title is one of the most important parts of the SEO title.

Good article titles clearly explain the task or question being answered.

Examples include:

• How to Install SoftwareRoad Knowledge Base
• How to Activate Your SoftwareRoad Knowledge Base Licence
• How to Create a Knowledge Base Category
• Fix Knowledge Base Search Returning No Results

Avoid vague titles such as:

• Setup
• More Information
• Important Help
• General Settings

The title should make sense when shown on its own in a search result.

Keep titles focused

Try to make each article cover one main subject.

For example:

How to Install and Activate SoftwareRoad Knowledge Base

may work as one article, but separate installation and activation guides are often easier to search and maintain.

Focused article titles also help visitors find the exact answer they need.

Meta descriptions

A meta description is a short summary of the page.

Search engines may display it underneath the page title in search results.

SoftwareRoad Knowledge Base can use the article excerpt or page content to create a description.

A manually written excerpt normally gives you the most control.

Add an article excerpt

To add an excerpt:

1. Open Knowledge Base > All Articles.
2. Edit the article.
3. Find the Excerpt panel.
4. Enter a short description of the article.
5. Select Update.

For example:

Learn how to activate SoftwareRoad Knowledge Base using the purchase email and product key connected to your subscription.

Keep the excerpt accurate and specific to the guide.

Write a useful meta description

A good description should tell visitors:

• What the article explains
• Which feature or problem it covers
• What they can expect to achieve

For example:

Learn how to create and organise parent and child categories in SoftwareRoad Knowledge Base for WordPress.

Avoid repeating the same general description across every article.

Each page should have wording that matches its own content.

Do not stuff descriptions with keywords

Use important phrases naturally.

For example, an article about creating categories may naturally include:

• WordPress knowledge base
• Knowledge base categories
• Parent and child categories

Do not repeat the same phrase several times simply to make the description longer.

The description should be written for a person deciding whether the article answers their question.

Canonical URLs

A canonical URL tells search engines which address should be treated as the main version of a page.

This can help when the same content could be reached through more than one route.

SoftwareRoad Knowledge Base can add the correct canonical address for its articles and category pages.

You do not normally need to enter canonical URLs manually.

Article structured data

Structured data gives search engines additional information about a page in a machine-readable format.

SoftwareRoad Knowledge Base can add article information such as:

• Article title
• Description
• Publication date
• Modified date
• Website information
• Page URL

This information is added behind the scenes and does not change the visible article design.

Breadcrumb structured data

When breadcrumbs are enabled, SoftwareRoad Knowledge Base can also describe the page path for search engines.

For example:

Knowledge Base > Getting Started > Installation

This helps show how the article fits into the wider documentation structure.

A clear category structure makes breadcrumb information more useful.

Category page SEO

Knowledge base categories can also appear in search results.

The category name and description help explain what the section contains.

To improve a category page:

1. Open Knowledge Base > Categories.
2. Edit the category.
3. Use a clear category name.
4. Add a useful description.
5. Select Update.

For example:

Category name

Licence and Subscription

Description

Find help with licence activation, product keys, Monthly and Yearly subscriptions, and licence checks.

Use focused category names

A category name should clearly describe the articles inside it.

Useful examples include:

• Getting Started
• Licence and Subscription
• Creating Articles
• Customisation
• Analytics
• Troubleshooting

Avoid unclear category names such as:

• General
• Other
• Information
• Miscellaneous

Clear category names improve navigation as well as SEO.

Keep category descriptions helpful

A category description should briefly explain what visitors will find.

For example:

Learn how to customise the knowledge base homepage, search area, category cards and article design.

One or two sentences are normally enough.

Avoid adding a long block of text above the category articles.

Article URL structure

SoftwareRoad Knowledge Base uses a URL base for articles.

An article URL may look similar to:

example.com/knowledge-base/how-to-create-a-category/

The final part of the address is based on the article slug.

Use short, descriptive slugs where possible.

Change an article slug

To edit the slug:

1. Open Knowledge Base > All Articles.
2. Edit the article.
3. Find the Permalink or URL setting.
4. Change the slug.
5. Select Update.

For example:

how-to-create-a-knowledge-base-category

is clearer than:

article-127

Be careful when changing the URL of an article that has already been published and shared.

Old links may stop working unless a redirect is added.

Avoid changing live URLs unnecessarily

Once an article is indexed or linked from other pages, changing its URL can create:

• Broken internal links
• Broken shared links
• 404 errors
• Lost search visibility
• Outdated automatic article links

Only change a live article URL when there is a clear reason.

After changing it, review links throughout the knowledge base.

Unlisted article SEO

An unlisted article remains available through its direct URL, but it is excluded from normal knowledge base discovery areas.

SoftwareRoad Knowledge Base also marks unlisted articles so search engines should not index them.

An unlisted article is normally excluded from:

• Knowledge base search
• Category listings
• Popular Articles
• Related Articles
• Recommended Articles
• XML sitemaps
• Search engine indexing

Unlisted does not mean private.

Anyone with the direct URL may still be able to open the article.

Inactive licence SEO protection

When the SoftwareRoad Knowledge Base licence becomes inactive, public plugin content may become unavailable.

The plugin can add noindex and nofollow instructions to unavailable knowledge base content.

This helps prevent search engines from indexing a licence or availability message instead of the real article.

Restoring the active licence allows the normal knowledge base content and SEO information to return.

Noindex and nofollow

Noindex asks search engines not to include a page in their search results.

Nofollow asks them not to follow links found on that unavailable page.

SoftwareRoad Knowledge Base uses these instructions where needed, such as for unlisted or unavailable content.

You do not normally need to add them manually.

SEO and existing website settings

If your website already has another system managing page titles, descriptions and structured data, SoftwareRoad Knowledge Base is designed to avoid adding unnecessary duplicate information where possible.

After enabling the built-in SEO options, inspect a public article and confirm that the page is not producing repeated title or description tags.

Use one main system to manage each type of SEO information.

Avoid duplicate page titles

Every article should have its own title.

Do not create several articles with nearly identical names such as:

• Licence Help
• More Licence Help
• Licence Help Guide
• Additional Licence Help

Use specific titles instead:

• How to Activate Your Licence
• Where to Find Your Product Key
• Fix Licence Details Not Recognised
• How Automatic Licence Checks Work

This makes the articles easier for visitors and search engines to distinguish.

Avoid duplicate article content

Two articles should not contain almost the same information.

If several guides repeat large sections, consider:

• Combining them
• Keeping one main guide
• Linking to the main explanation
• Using automatic article links
• Adding a short summary and linking to the full guide

Each article should have a clear purpose.

Use headings correctly

Headings help visitors and search engines understand the structure of the guide.

Use:

• Heading 1 for the article title
• Heading 2 for main sections
• Heading 3 for smaller sections within them
• Heading 4 only when needed

Do not add another Heading 1 inside the article content.

Avoid using headings purely to make text look larger.

Include useful internal links

Link to related documentation when it helps the visitor complete a task.

For example, an activation article could link to:

• Where to Find Your Product Key
• How Automatic Licence Checks Work
• Fix Licence Details Not Recognised

You can add links manually or use Automatic Article Links for common phrases.

Do not add unrelated links simply for SEO.

Keep articles up to date

Search results are more useful when the article matches the current plugin version.

Review guides when you change:

• Menu names
• Settings
• Licence behaviour
• Features
• Page layouts
• Screenshots
• Troubleshooting steps

The article modified date can also be included in its structured data.

Only update the article date when the content has genuinely been reviewed or changed.

Use the article’s main wording naturally

Think about the phrase someone may search for.

For example, this article may naturally use phrases such as:

• WordPress knowledge base SEO
• Knowledge base SEO settings
• SEO for knowledge base articles
• WordPress knowledge base plugin

Use the main phrase where it makes sense in:

• The article title
• The opening paragraph
• A heading
• The excerpt
• The article content

Do not force it into every section.

Add useful images

Screenshots can make technical articles easier to follow.

When uploading an image:

• Use a descriptive filename
• Add suitable alternative text
• Compress the file
• Resize it before uploading
• Keep screenshots current

For example:

software-road-knowledge-base-seo-settings.webp

Alternative text should describe what the image shows rather than list keywords.

Image alternative text

Alternative text helps visitors who cannot see the image.

A useful example would be:

SoftwareRoad Knowledge Base Privacy and SEO settings in WordPress

Avoid alternative text such as:

knowledge base WordPress SEO plugin best SEO knowledge base

Write it as a normal description.

Page speed and SEO

A fast knowledge base is easier for visitors to use.

To keep article pages reasonably quick:

• Compress screenshots
• Avoid uploading very large images
• Remove unnecessary embeds
• Keep the article layout focused
• Avoid loading duplicate features
• Use a sensible caching setup

The built-in SEO options themselves should not visibly slow down the page.

Check the public page title

After enabling SEO:

1. Open a published article.
2. Check the browser tab title.
3. Confirm that it matches the article.
4. Make sure the website name is not repeated unnecessarily.
5. Check a category page as well.

The visible article heading and browser title do not have to be identical, but they should describe the same subject.

Check the page description

The meta description is not normally visible on the article page.

You can inspect it using your browser’s page source or development tools.

Look for a description tag containing a short summary of the article.

If the description is poor or missing, add a clear manual excerpt to the article.

Check structured data

Structured data is added inside the page source.

You can inspect the source and look for JSON-LD information describing the article or breadcrumbs.

The code is not intended to be read by normal visitors.

If the article looks correct publicly, do not edit the structured data manually.

The SEO title is wrong

If the browser or search result title does not match the article:

• Check the article title
• Check the saved SEO settings
• Clear the WordPress cache
• Clear any server cache
• Make sure only one SEO system is controlling the title
• Check whether a search engine has stored an older version

Search engines may choose their own title or continue displaying an older title until the page is crawled again.

The meta description is missing

Check that:

• Built-in SEO is enabled
• The article is published
• The article has an excerpt or suitable content
• The settings were saved
• Your licence is active
• The page cache has been cleared

Add a manual excerpt and update the article.

The wrong description appears

The description may be taken from:

• The manual excerpt
• The article introduction
• Existing website SEO settings
• An older cached version

Review the article excerpt first.

After changing it, clear the website cache and check the public page source again.

Duplicate SEO tags appear

If the source contains more than one title, description or canonical tag, your website may have more than one SEO system active.

Review:

• SoftwareRoad Knowledge Base SEO settings
• Theme SEO options
• Custom website code
• Other active SEO features

Choose which system should manage the knowledge base SEO and disable the duplicate output.

Search engines show old wording

Search engines do not update results immediately after you change an article.

First check that the public article contains the correct title and description.

If the live page is correct, the search result should update when the page is crawled again.

Cached search results are outside the direct control of SoftwareRoad Knowledge Base.

An article is not appearing in search results

Check that:

• The article is published
• It is not marked as unlisted
• Your licence is active
• The article is not blocked by website-wide privacy settings
• The article URL works
• No noindex instruction is being added
• The page is linked from the knowledge base
• The website is available to search engines

Search engines decide which pages to index, so enabling SEO does not guarantee that every article will appear.

A category page is not indexed

Make sure that:

• The category contains published articles
• The category has a useful name and description
• The public category URL works
• It is linked from the knowledge base homepage
• The licence is active
• The website is not blocking indexing

An empty category provides little useful content and may not appear publicly.

Changes are not appearing

After updating SEO settings or article information:

1. Select Save Changes.
2. Update the article or category.
3. Clear the WordPress cache.
4. Clear any hosting or server cache.
5. Clear your browser cache.
6. Open the public page in a private browser window.

Check the live published page rather than a WordPress preview.

Built-in SEO checklist

Before finishing, check that:

• Built-in Knowledge Base SEO is enabled
• Article titles clearly explain each topic
• Important articles have manual excerpts
• Category names and descriptions are useful
• URLs are short and descriptive
• Unlisted articles are marked noindex
• Articles use a clear heading structure
• Useful internal links have been added
• Images are compressed and have suitable alternative text
• Duplicate SEO tags are not being created
• Published pages work while signed out
• Your SoftwareRoad Knowledge Base licence is active

The built-in SEO features are now ready to help search engines understand your WordPress knowledge base articles and categories.