Category

How to Create and Manage Knowledge Base Articles in BoldDesk

Updated:

The Knowledge Base module in BoldDesk enables teams to create structured help content for customers and support agents. Articles are organized under Categories and Sections, making content easier to manage in the Agent Portal and discover in the Customer Portal. Authorized agents can create content manually, generate an initial draft with AI, improve existing content using AI Assist, manage article settings and SEO, submit articles for review, and publish approved content.

Common Use Cases

Use Case Description
Customer self-service Publish how-to guides, FAQs, and troubleshooting articles in the Customer Portal.
Internal documentation Create operational guides and restrict visibility to support agents or selected users.
Content review Save drafts and send articles for review before publication.
Time-sensitive content Set an expiration date for temporary notices, announcements, or instructions.
AI-assisted writing Generate an article draft from a topic or improve existing content with AI Assist.
  • Every article must belong to an existing Category or Section. Create the required structure before creating an article. Explore Organizing Knowledge Base: Categories and Sections in BoldDesk.
  • Knowledge Base images and GIFs are optimized based on their content and intended purpose rather than a fixed file-size target. Applying uniform size limits (for example, 100 KB for images or reducing all GIFs by 1 MB) may impact screenshot readability, instructional clarity, and the effectiveness of visual demonstrations. While page performance is continuously evaluated and optimization opportunities are explored, media assets are balanced to preserve both loading performance and the quality of documentation.

Prerequisites

Before creating an article, ensure that:

  • You can access the Knowledge Base module.
  • Your role includes the Create Article permission.
  • A Category or Section is available for the article.
  • You have the appropriate review or publication permission for the required workflow.
  • AI Assist is enabled and assigned to your account if you want to use AI writing features.

Create an Article

1. Open the Create Article Page

Use either of the following methods:

  1. Open the Knowledge Base module, select the required Category or Section, and choose the option to create an article.

    Knowledge base article.png

  2. Click Create in the upper-right corner of the Agent Portal and select Article.

    Global Create button.png

The Create Article page opens with two writing options:

  • Write with AI

  • Write manually

    Create Article page.png

Create an Article with AI

Use Write with AI when you want BoldDesk to create an initial article draft from a topic description.

1. Describe the Article

  1. On the Create Article page, select Write with AI.
  2. In What do you want to write about?, describe the required article.
  3. Include the important details that the generated article must cover, such as:
    • Intended audience.

    • Product or feature.

    • Required procedures.

    • Common errors.

    • Expected outcomes.

    • Article type, such as a how-to guide, FAQ, or troubleshooting article.

      Describe the article.png

The article topic description supports up to 2,000 characters, including spaces and line breaks. Provide the essential scope, required sections, current BoldDesk UI labels, and expected output within this limit.

2. Configure the Article Settings

Expand Article settings, then select the required Article Type, Tone, Length, and Language. You can select Let AI decide under Article Type to allow BoldDesk AI to choose the most appropriate article format.
Provide enough context for the generated draft without including passwords, API keys, payment information, personal information, or other sensitive data.

Configure the Article Settings.png

3. Generate and Review the Article

  1. Click Generate Article.

  2. Review the generated title and content.

  3. Correct inaccurate or incomplete information.

  4. Update the article settings.

  5. Save the article as a draft, send it for review, or publish it according to your permissions.

    Generate and review the article.gif

AI-generated content must be reviewed before publication. Confirm that UI labels, navigation paths, product behavior, links, and limitations match the current BoldDesk interface.

For detailed AI generation instructions, explore How to Generate Knowledge Base Content Using BoldDesk AI.

Create an Article Manually

Use Write manually when you want to enter and format the article content directly.

Create article manually.png

1. Open the Manual Editor

On the Create Article page, select Write manually.
The manual editor displays:

  • Article title.

  • Editable article slug.

  • Article description and body.

  • Editor formatting controls.

  • Settings panel.

  • SEO panel.

  • Draft, review, and publication actions.

    Manual Editor.png

2. Enter the Article Content

Complete the following fields:

Field Description
Title Enter a clear title that describes the task or information covered by the article.
Slug Review the generated URL slug and edit it when required.
Description Enter and format the main article content.

The WYSIWYG editor is displayed for manual writing. To work with Markdown, click Switch to Markdown Editor.

The available formatting options include:

  • Headings and paragraphs.
  • Bold, italic, underline, and strikethrough.
  • Text and highlight colors.
  • Links.
  • Images and files.
  • Tables.
  • Lists.
  • Quotes.
  • Alignment and indentation.
  • Other supported content elements.
  • Switching between the WYSIWYG Editor and Markdown Editor clears the content currently entered in the editor. Select the required editor before drafting the article.
  • If you need to change editors after writing content, copy the content to a secure location before switching, and then review the formatting after pasting it into the selected editor.

For editor-specific guidance, explore:

Improve Article Content with AI Assist

AI Assist is available from the article editor when the required feature and access are enabled.

Use an AI Assist Action

  1. Select the content you want to update.

  2. Open AI Assist from the editor.

  3. Select one of the available actions:

    • Improve
    • Rephrase
    • Elaborate
    • Shorten
    • Correct Grammar
    • Translate
  4. Review the generated result before applying it.

    AI Assist.png

Give AI Assist a Custom Instruction

The AI Assist dialog also allows you to describe the required change in Tell AI what to change.
For example:

  • Make this section more concise.
  • Add a troubleshooting section.
  • Rewrite this content for administrators.
  • Convert these paragraphs into numbered steps.
  • Improve the clarity without changing the meaning.

Where available, select the required writing style:

  • Standard

  • Fluent

  • Professional

    give AI Assist a custom instruction.gif

Review the generated preview, and use Regenerate when another result is required.

AI Assist enhances the selected content but does not replace product verification. Review all generated content before saving or publishing the article.

Configure Article Settings

Use the Settings panel on the right side of the editor to configure the article.

Setting Description
Category-Section Select the Category or Section where the article will be stored.
Allow Comments Allow customers to comment on the published article. This option is enabled by default.
Visibility Select who can access the article.
Tags Add relevant tags to improve organization and discovery.
Article Expires On Select the date and time when the article should stop appearing in the Customer Portal. Leave the field empty for content without an expiration date.
Status Indicator Display the applicable status indicator for new or updated content in the Customer Portal.

Article setting.png

The selected visibility determines whether the article is available publicly, to signed-in contacts, to specific users, or internally, according to the options available in the portal.

Article expiration affects Customer Portal visibility. The article remains available for authorized agents in the Knowledge Base module.

Configure SEO Settings

Open the SEO panel to configure search and sharing information.
Depending on the available settings, configure:

  • Meta title.

  • Meta description.

  • Canonical URL.

  • Search indexing.

  • Sitemap inclusion.

  • Open Graph image.

  • Open Graph title.

  • Open Graph description.

    Configure SEO settings.png

Use a unique meta title and description that accurately represent the article. Configure the canonical URL when another page should be treated as the preferred version of the content.

Import Article Content

Use Import when you want to create the article from a supported external file or content source.
After importing:

  1. Review the title and body.

  2. Correct the formatting.

  3. Remove unsupported or unnecessary content.

  4. Configure the Category or Section.

  5. Review visibility, expiration, and SEO settings.

  6. Save or submit the article through the required workflow.

    Import.png

Save, Review, or Publish the Article

The actions displayed at the top of the editor depend on the article state and your permissions.

Action Result
Discard Removes the unsaved changes from the current editing session.
Save as Draft Saves the article without publishing it in the Customer Portal.
Send to Review Moves the article to the review workflow.
Publish Publishes the article for users allowed by the configured visibility.

Save or publish.png

The dropdown beside Send to Review can display additional actions available for your permissions and the current article state.

  • Users with review permission can review an article in the review state.
  • Users with publish permission can publish the article.
  • Saving an article as a draft does not make it visible in the Customer Portal.

Preview an Article

Use Preview Draft to review unpublished changes before publication.
Preview the article to verify:

  • Heading hierarchy.
  • Tables and lists.
  • Images and attached files.
  • Links.
  • Info, note, and warning callouts.
  • Code blocks.
  • Customer Portal layout.
  • Mobile readability.

    Preview.png

The Preview Draft option appears when the article contains unpublished changes.

Edit an Article

To edit an existing article:

  • Open the article from the Knowledge Base article list.
  • Click Edit.
  • Update the title, content, settings, or SEO information.
  • Use Preview Draft to review unpublished changes.
  • Choose the required action:
    1. Discard
    2. Save as Draft
    3. Send to Review
    4. Publish

      Edit an article.png

Published content remains visible in the Customer Portal until the updated version is published or the article is unpublished.

Changes to article content are maintained through BoldDesk article versioning. Review the applicable version before publishing an update.

Unpublish an Article

Unpublish an article when it should no longer be displayed in the Customer Portal.

  1. Open the published article.

  2. Click Unpublish.

  3. Confirm the action.

    Unpublish an article.png

After unpublishing:

  • The article is removed from the Customer Portal.
  • The article is no longer available through Customer Portal search.
  • The article remains available to authorized agents.
  • The article status changes to Draft.
  • A new article version is created.

Clone an Article

Clone an article when you want to reuse its primary-language content.

  1. Open the article.

  2. Click Clone.

  3. Review the prepopulated content and settings.

  4. Update the title, content, Category or Section, visibility, and other settings.

  5. Click Clone to create the new article.

    Clone article.png

Cloning duplicates only the article content from the primary language. Existing translations are not included in the cloned article.

Delete an Article

To delete an article:

  1. Open the article.

  2. Click Delete.

  3. Confirm the deletion.

    Delete an article.png

The article is moved to the deleted state.
Deleted articles can be restored from Deleted Articles. For instructions, explore How to Restore Deleted Articles in the Knowledge Base.

Estimated Read Time

BoldDesk calculates the estimated article read time automatically from the word count and rounds the result to the nearest displayed whole minute.

The calculation uses:
(Total Word Count + 1) / 250

The Customer Portal read time is updated when the article is published as a new major version. Minor content changes that do not materially change the word count may display the same reading time.
If the updated read time is not displayed:

  1. Publish the article changes.
  2. Refresh the Customer Portal page.
  3. Clear the browser cache if the older value remains visible.

Troubleshooting

Write with AI Is Not Available

Confirm that:

  • AI Assist is enabled for the organization.
  • Smart Article Assistant or KB article generation is enabled.
  • Your account has the required AI Assist access and permissions.

AI Assist Is Not Available in the Editor

Confirm that:

  • AI Assist is enabled.
  • Writing Assistant content enhancement is enabled.
  • You have AI Assist access.
  • Editable article content has been entered or selected.

Generate Article Is Unavailable

Enter a sufficiently detailed topic description. Review any required fields under Article settings, and then retry.

Category-Section Cannot Be Selected

Confirm that:

  • A Category or Section has been created.
  • You can access the Category or Section.
  • Your role has the required Knowledge Base permissions.

Send to Review Is Not Available

Confirm that:

  • The article has been saved.
  • Your role can submit articles for review.
  • The Knowledge Base review workflow is available for the article state.

Publish Is Not Available

Confirm that your role has the required publish permission. If you do not have permission, use Send to Review.

Customers Cannot Find the Published Article

Review:

  • Article visibility.
  • Category and Section visibility.
  • Brand configuration.
  • Article expiration.
  • Customer Portal Knowledge Base settings.
  • Search-indexing settings.
  • Publication status.

Preview Shows Incorrect Formatting

Review the content in the selected editor. If the article was switched between WYSIWYG and Markdown, correct any unsupported or altered formatting before publishing.

Frequently Asked Questions

  1. Can I create an article without a Category?
    No. Every article must belong to an existing Category or Section.

  2. Can I create an article using AI?
    Yes. Select Write with AI, describe the required topic, generate the article, and review the generated draft before saving or publishing it.

  3. Can I write an article manually?
    Yes. Select Write manually and use the WYSIWYG editor or switch to the Markdown editor.

  4. Can AI Assist improve an existing article?
    Yes. AI Assist can improve, rephrase, elaborate, shorten, correct grammar, or translate selected article content when the applicable feature and access are enabled.

  5. Can I tell AI Assist exactly what to change?
    Yes. Use Tell AI what to change to provide a custom instruction, such as making the content concise or adding a troubleshooting section.

Related Articles

  1. Organizing Knowledge Base: Categories and Sections in BoldDesk
  2. How to Generate Knowledge Base Content Using BoldDesk AI
  3. How to Configure Smart Article Assistant in BoldDesk
  4. How to Use the AI Copilot Writing Assistant in BoldDesk
  5. How to Format Articles Using the WYSIWYG Editor in BoldDesk
  6. How to Format Article Content Using the Markdown Editor
  7. How to Restore Deleted Articles in the Knowledge Base
Was this article useful?
Like
Dislike
Help us improve this page
Please provide feedback or comments
Comments (0)
Access denied
Access denied
Access denied
Access denied

No articles or sections found
No articles or sections found