SEO metadata determines how a knowledge base article appears in search engine results and when it is shared on social media platforms. Clear and accurate metadata can improve an article’s visibility, discoverability, and click-through rate. This article explains how administrators can configure SEO-related settings and how authors can add, update, generate, and validate SEO metadata for knowledge base articles.

BoldDesk provides the following SEO metadata fields:

Authors can manually enter and update these fields when creating or editing an article. Administrators can also make all SEO metadata fields mandatory before an article can be saved as a draft or published. Additionally, BoldDesk AI can generate a Meta Description based on the article’s content when Article SEO Optimization is enabled.

Configure Article SEO Optimization

Article SEO Optimization allows BoldDesk AI to generate Meta Description suggestions for knowledge base articles.
Enabling or disabling this setting does not affect the availability of the SEO metadata fields. Authors can manually enter or update all metadata fields regardless of whether Article SEO Optimization is enabled.

Enable Article SEO Optimization

To enable AI-powered Meta Description generation:

1. Navigate to AI Module > AI Copilot.

2. Enable AI Copilot if it is not already enabled.

3. Select Smart Article Assistant.

4. Turn on Article SEO Optimization.

5. Save the changes.
   

   
   
   

After Article SEO Optimization is enabled, authors can generate Meta Description suggestions from the SEO section of a knowledge base article.

Disable Article SEO Optimization

To disable AI-powered Meta Description generation:

1. Navigate to AI Module > AI Copilot.

2. Select Smart Article Assistant.

3. Turn off Article SEO Optimization.

4. Save the changes.
   

   
   
   

Manage SEO Metadata for an Article

Authors can manually add or update SEO metadata for every knowledge base article. If Article SEO Optimization is enabled, they can also use BoldDesk AI to generate a Meta Description.

Generate an AI-powered Meta Description

When Article SEO Optimization is enabled, authors can use BoldDesk AI to generate a Meta Description based on the article’s content.
To generate a Meta Description:

1. Open the required knowledge base article.

2. Ensure that the article contains clear and sufficient content.

3. Navigate to the SEO section.

4. Select Generate Meta Description.

5. Review the generated description.

6. Modify the description if necessary.

7. Manually enter or update the remaining SEO metadata fields:

   • Meta Title
   • OG Title
   • OG Description

8. Save or publish the article.
   

   
   
   

Add or update SEO metadata manually

Manual entry is available regardless of whether Article SEO Optimization is enabled.
To add or update SEO metadata:

1. Open the required knowledge base article.

2. Navigate to the SEO section.

3. Enter or update the following fields:

   • Meta Title
   • Meta Description
   • OG Title
   • OG Description

4. Review the metadata for accuracy.

5. Save or publish the article.
   

   
   
   

Enforce SEO Metadata Requirements

Administrators can require authors to complete all SEO metadata fields before saving or publishing knowledge base articles.
When SEO metadata enforcement is enabled, the following fields become mandatory:

• Meta Title
• Meta Description
• OG Title
• OG Description

Enable mandatory SEO metadata

To make SEO metadata mandatory:

1. Navigate to Admin > Agent Portal > Knowledge Base.

2. Locate Enforce SEO-related Attributes.

3. Enable the option.

4. Save the changes.
   

   
   
   

After the setting is enabled, authors must provide values for all required SEO metadata fields before they can save an article as a draft or publish it.

Disable mandatory SEO metadata

To make SEO metadata optional:

1. Navigate to Admin > Agent Portal > Knowledge Base.

2. Locate Enforce SEO-related Attributes.

3. Disable the option.

4. Save the changes.
   

   
   
   

After the setting is disabled:

• Authors can save or publish articles without completing all SEO metadata fields.
• The SEO metadata fields remain available for optional manual entry.
• Existing SEO metadata remains unchanged.

SEO attribute validation (Meta Title / Meta Description)

When updating Meta Title or Meta Description in the SEO tab of a Knowledge Base article, BoldDesk validates the value before saving. If the value contains an unsupported character, BoldDesk displays a validation error under the field indicating that the value cannot contain the specific character (for example: “Invalid or value cannot contain ‘<’.”).

What to do: Remove or replace the exact character shown in the error message, then save again.

Troubleshooting

The Generate Meta Description option is unavailable
This issue can occur when:

• AI Copilot is disabled.
• Article SEO Optimization is disabled.
• You do not have the required permissions.

Resolution:

• Confirm that AI Copilot is enabled.
• Confirm that Article SEO Optimization is enabled.

The article cannot be saved because SEO metadata is missing
This issue occurs when Enforce SEO-related Attributes is enabled and one or more required fields are empty.
Resolution:

• Open the article’s SEO section.
• Complete the following fields:
  • Meta Title
  • Meta Description
  • OG Title
  • OG Description
• Save or publish the article again.

The article cannot be saved because of an invalid value
This issue occurs when the Meta Title or Meta Description contains an unsupported character.
Resolution:

• Review the validation message.
• Identify the unsupported character.
• Locate the affected field in the SEO section.
• Remove or replace the character.
• Save or publish the article again.

Frequently Asked Questions

1. What does “Mandatory to fill SEO Attributes” do in BoldDesk?
   When enabled, the Mandatory to fill SEO Attributes option enforces SEO completion by prompting authors to fill these fields before publishing eligible articles: Meta Title, Meta Description, OG Title, and OG Description.

2. Can I generate the Meta Description SEO field using AI in BoldDesk?
   Yes. BoldDesk supports using AI to generate meta descriptions for Knowledge Base articles.

3. Where do I enable the “Mandatory to fill SEO Attributes” option?
   Enable it from the Agent Portal settings:

   • Go to Admin → Agent Portal → Knowledge Base
   • In the Knowledge Base tab, enable the option under Enforce SEO-related attributes.

4. Does SEO enforcement apply to all Knowledge Base articles?
   No. The enforcement applies only to publicly visible articles whose status is not Draft.

Related Articles

1. How to Configure Smart Article Assistant in BoldDesk
2. How to Create and Manage Knowledge Base Articles in BoldDesk