Set up your documentation site

Documentation is a paid module

It is an add-on at 19 US dollars a month, and it is not part of a new account. If your account does not have it, the documentation option in the New menu shows as a padlocked Documentation — upgrade to add rather than failing when you click it.

1. Create a documentation set

1. Go to Brand → Knowledge. (New to that menu? See what a brand is in Yaplet.)
2. Click New above the table and pick New documentation.
3. It is created immediately with a default name and you land in its editor. Rename it on its Settings page whenever you like.

You can keep several documentation sets in one brand — up to five per brand on any paid plan. All of them feed your AI, and exactly one of them can be on the brand's public web address at a time.

2. Add categories

Categories appear as navigation tabs across the top of the public site. Think of them as the manual's parts: "Getting started", "API reference", "Configuration".

1. Open your documentation set.
2. Click New Category.
3. Give it a name — that name is the tab label — and an optional description.
4. Repeat for as many as you need.

With only one category the tab bar is hidden, which reads better for a small set. See how to organize documentation categories for ordering and structure.

3. Add pages

Inside a category the pages form a tree: pages can have child pages, which can have their own children, as deep as you need.

1. Open a category by clicking its name.
2. In the left tree panel, click Add Root Item at the bottom.
3. Give the page a title in the right-hand panel and write the body in the markdown editor.
4. For a child page, open the parent's three-dot menu and choose Add Child. Pages that already have children also show an inline Add Child link at the end of the child list.

4. Put it on your public web address

There is nothing to connect to a chat widget. On Brand → Knowledge, open the documentation set's three-dot menu and choose Show at your-address.yaplet.help. It is then served at:

https://your-address.yaplet.help/d/

A brand serves one documentation set at a time, so putting a second one up takes the first one down — nothing is deleted and nothing leaves your AI, it just stops being served. The address itself is a brand setting, at Brand → Brand settings → Public address. A chat widget is not required for any of this.

5. Publish the categories and pages

Being on the web address is not the same as being visible. Each category and each page has its own Published switch, and a page only shows once its category is published too. See Make your documentation visible to visitors for the order to do it in and the bulk shortcuts.

Where the logo and the language live

The logo at the top of your public documentation is no longer uploaded per documentation set. Its Settings page now carries a note — "The logo lives on the brand now" — with a button to Brand settings, where you set it once on the General tab, in the Brand images section, under Brand logo — and it is then used everywhere this brand publishes. A set that still carries an older logo of its own keeps using it until the brand is given one.

The language is an inline picker in the Language column on Brand → Knowledge, and it saves the moment you change it. It decides how your AI searches this text — it does not translate anything.