Create your first knowledge base article

Updated May 22, 2026

Creating a knowledge base article takes a handful of steps. By the end you will have a published article that visitors can read and that your AI can answer from.

Can anything stop you publishing? You can write knowledge base articles on any plan, and Yaplet learns a published article as long as something can pay for it: your free 14 days, credit you bought, or a paid plan. If none of them can, the article still publishes, and Yaplet learns it within the hour after you add credit or choose a plan. Only older free workspaces that still have free monthly answers have a fixed count — 250 indexed items across the whole workspace — and an indexed item is a block of content your AI has stored, so one long article is usually several of them. See the Free plan limits article for the full picture.

1. Open your knowledge base

Go to Brand → Knowledge. Your knowledge bases are the rows in the Knowledge bases & documentation group — click one to open it. To start a new one, click Add knowledge at the top of the page and pick Knowledge base (in the part called Help content customers can read too). It is created straight away with the name “Knowledge Base”, and you land in the editor. (New to that menu? See what a brand is in Yaplet.)

If nothing is on the brand's public web address yet, a new knowledge base goes onto it straight away. If another one is already On public site, the new one starts as AI only — it still feeds your AI, but nobody can browse it until you put it on the address.

2. Navigate to a category

Articles always live inside a category. Click an existing category to open it, or create one with New Category on the knowledge base's own page — it is created straight away as “New category” and opens its settings, where you give it a real name and save. You can nest categories up to four levels deep — see how to organize categories for details.

3. Create the article

Inside the category, click New Article. The article editor opens.

4. Fill in the basics

  • Title — required. Shown as the article's heading in the widget and on the public page. Keep it short and specific: "Reset your password", not "Password information".
  • Language — the language this version of the article is written in. For an article in the knowledge base's main language it is only shown, not editable; you choose a language when you add a translation.

5. Write the body

The body editor is a rich-text editor — similar to a word processor. Use headings to break the article into sections, bullet lists for parallel items, and numbered lists for steps. See Use the rich-text editor for a full guide to the formatting options.

6. Publish

When you are ready, turn the Published switch on and click Save changes. The article is now:

  • Added to your AI's knowledge immediately — no AI agent and no chat widget needed. Editing and saving it again re-indexes just that article; switching Published off removes it from the AI again.
  • Visible on your brand's public web address, if this knowledge base is the one currently on that address.
  • Visible in the chat widget's Help tab, under the same condition.

You can unpublish at any time to take the article offline without deleting it. On an older free workspace that has already used all 250 of its indexed items, the editor will not let you publish at all: the Published switch is grayed out, with the reason written under it — "You have used all 250 of 250 indexed items on the free plan. Unpublish something or upgrade to publish this article." Unpublish some older content or upgrade, then come back and turn the switch on.

Next up: learn how to format your article with headings, images, and tables.

Did this article answer your question?