Creating a new Knowledge Base article
The instructions below are for desktops and laptops only.
Publishing articles in your tawk.to Knowledge Base makes it easy for both your agents and customers to find answers quickly.
You can also display helpful articles in your chat widget, making it even easier for customers to get support.
With AI Assist, you can use AI Commands to help write and edit Knowledge Base articles. Your published articles can also serve as a data source for AI-powered replies, helping your AI agent deliver more accurate and relevant answers in conversations.
In this guide, we’ll cover:
Creating a new Knowledge Base article
Document settings in the left panel of the article editor
Writing and formatting your article using content blocks
Writing Knowledge Base articles with AI Assist
Publishing your article or saving it as a draft
Adding Knowledge Base articles to your chat widget
Using Knowledge Base articles as AI Assist’s data source
Creating a new article

3. Click Knowledge Base on the top menu.

4. You’ll be taken to the Knowledge Base dashboard, where you can manage articles, categories, and settings.

5. In the left panel, click + Create, then select Article from the dropdown.

This opens the article editor in split view:
- Use the left panel to manage document and content block settings.
- Use the right panel to add and format your article content using blocks (text, images, videos, etc.).

Document settings (left panel)
The left panel controls how your article appears to readers, search engines, and your internal team.

The slug is the last part of the article’s URL.
For example:
http://kb123.tawk.help/creating-a-new-article
You can edit the slug if you want a custom URL. If you leave it blank, the slug will be created automatically based on your article title.

Choose your article’s status:
Draft – A work in progress. Only your team can see it.
Published – The article is live and visible to everyone.
Archived – Store older or outdated articles without deleting them.

Control who can access the article:
Public – The article will be visible to everyone and indexed by search engines.
Private – Only visible to your logged-in team members. This is useful for internal guides or notes.


You can:
Search for existing categories
Click + Add Category to create a new one
Check the box to assign a category
Click the pin icon to set the primary category.



Write a summary (155–160 characters) that explains what the article is about. This helps search engines display your article in relevant search results.

Upload an image that appears when your article is shared on social platforms. Choose a clean, branded image to attract more clicks.

Suggest other helpful articles for readers. These will be displayed at the bottom of the published article to encourage deeper engagement.



Title and subtitle
Title (required): This becomes your article’s main heading (H1) and the slug.
Subtitle (optional): A summary that helps readers understand the article’s purpose at a glance.
Content blocks
Click the green + icon to add content blocks. You can adjust the block settings in the left panel.
Drag blocks using the handle to reorder them, or click the trash icon to remove a block.
Here are the types of content blocks you can add to your article:

Writing Knowledge Base articles with AI Assist
If you’ve enabled AI Assist, you can use AI Commands to help you write and refine content directly within the Knowledge Base article editor.
Enable Knowledge Base and AI Commands for your AI agent
To get started:
1. Go to your AI agent’s settings. Enable Knowledge Base under the Channels section.

2. Scroll down and switch AI Commands on.

This allows you to use AI-driven writing prompts directly in the article editor.
Using AI Commands in your article
Once enabled, you can trigger AI Commands inside any paragraph block of your article.
Here’s how:
1. Type “/ai” in a paragraph block.
2. A list of AI Commands will appear.

3. Choose the command you want and follow the prompt.
Example: Brainstorming article ideas
1. Select ai-brainstorm.
2. Enter a short description of the topic or question you want to explore.

3. AI Assist will begin listing relevant ideas.

When AI Assist finishes, you can choose:
- Done – Insert the generated content into your article as plain text
- Continue writing – Expand on the current response
- Retry – Remove the response and try again with a new prompt
- Discard – Delete the AI Command and start fresh

Example: Building the article outline
1. Use ai-task to turn your brainstormed ideas into a clear article structure.

2. AI Assist will generate a step-by-step layout that you can expand and refine.

Refine your writing
You can also use commands like the ones below to refine your article:
ai-tone – Adjust the tone (e.g., friendly, professional)
ai-fixtext – Fix grammar, spelling, or awkward phrasing
ai-pointexpand – Expand a specific bullet point or short idea into a full paragraph
See this guide to learn all about AI Commands:
Publish your article or save a draft
Once you’ve finished editing and formatting, click Publish in the left panel to make your article live and accessible to your audience. You can also click Save Draft to edit the article further and publish later.

Adding articles to your chat widget
You can display Knowledge Base articles inside your chat widget to offer help before a chat even begins. See this guide to learn how: How to modify your widget content
Using Knowledge Base articles as AI Assist’s Data Source
Your published Knowledge Base articles can be used by AI Assist to deliver fast, accurate responses in customer conversations.
To make this work:
Ensure your Knowledge Base articles and categories are enabled as a data source in your AI Agent settings.

As long as your articles are clear and up-to-date, your AI agent will use them to provide helpful, consistent answers. This enables your AI agent to reference your actual support content, ensuring replies are aligned with your current processes and policies.
To learn more about AI Assist’s data sources, see these guides:
Understanding AI Assist’s data sources
Formatting
Keep layout, tone, and design consistent across articles.
Use clear headings and bullet points to improve readability.
SEO best practices
Use descriptive, keyword-rich titles and headings.
Fill in the meta description with relevant information.
Add image alt text and use natural language.
Content maintenance
Review articles regularly to keep them accurate and up to date.
Archive or update content as needed.
To learn more about the Knowledge Base, see these guides:
Setting up your Knowledge Base
Creating Knowledge Base categories
If you have feedback about this article, or if you need more help:
Click the green live chat icon
Schedule a call with us
Visit our community