> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hiveku.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Write a Help Article

> Write an answer once, publish it, and see visitors find it in your website chat and your website assistant answer from it

A help article answers one question for everyone who asks it. Once it is public, visitors can find it from the chat on your website, and your website assistant answers from it.

This guide writes Northwind's first article, "How fast do you ship?", and checks it in the chat on the live Northwind site.

## Open the knowledge base

Click **Helpdesk** in the left rail, then **Agent** at the top, then **Knowledge base**.

![The Helpdesk tabs with the Agent menu open: Avery's memory, Knowledge base and Macros, with Knowledge base outlined](https://mintcdn.com/locusdigital/Cbg2UXFY0C93pKnG/images/how-tos/helpdesk/kb-01-open-closeup.webp?fit=max\&auto=format\&n=Cbg2UXFY0C93pKnG\&q=85\&s=60508d5c936e70681f801e5771a9ec8e)

## Write the article

**1. Click New article**

Click **New article** at the top right.

**2. Fill it in**

* **Title**: the question, in your customers' words.
* **Excerpt**: one line that answers it. Visitors see it in the search results.
* **Body (markdown)**: the full answer. Short paragraphs and lists read best in the chat.
* **Tags**: a few words that group related articles, separated by commas.

**3. Make it public and publish**

Set **Visibility** to **Public (customer help center)** and click **Publish**. **Draft (only you)** keeps it out of the chat and away from customers while you write (your team can still see it), and **Internal (team only)** is for your team and your helpdesk agent.

![New KB article: the title How fast do you ship?, the excerpt, a short body with a list, Visibility Public (customer help center) and the Publish button, outlined](https://mintcdn.com/locusdigital/Cbg2UXFY0C93pKnG/images/how-tos/helpdesk/kb-02-write-the-article-closeup.webp?fit=max\&auto=format\&n=Cbg2UXFY0C93pKnG\&q=85\&s=fffa70fb840d17c2fc13ced7c430aa08)

The article is now in the list with a **Public** badge.

![The Knowledge base with 1 public article: How fast do you ship?, tagged shipping and orders, with the Public badge, outlined](https://mintcdn.com/locusdigital/Cbg2UXFY0C93pKnG/images/how-tos/helpdesk/kb-03-published-closeup.webp?fit=max\&auto=format\&n=Cbg2UXFY0C93pKnG\&q=85\&s=49017abaf4de6ac614da776caa90b483)

## See it in your website chat

Once you have a public article, the chat on your site shows **Search for help** on its first screen.

![The open chat on the Northwind site, with the Search for help box outlined under Send us a message and Talk live](https://mintcdn.com/locusdigital/Cbg2UXFY0C93pKnG/images/how-tos/helpdesk/kb-04-search-for-help-closeup.webp?fit=max\&auto=format\&n=Cbg2UXFY0C93pKnG\&q=85\&s=e7be995129c2bb2cc146ee9ad468b9eb)

A visitor types a few words, picks the article and reads it without leaving the page. **Still need help? Send us a message** under the article starts a chat with your team.

![The article How fast do you ship? open in the chat, with its text and list outlined](https://mintcdn.com/locusdigital/Cbg2UXFY0C93pKnG/images/how-tos/helpdesk/kb-05-article-in-chat-closeup.webp?fit=max\&auto=format\&n=Cbg2UXFY0C93pKnG\&q=85\&s=2cc6622374f8a0f16ee499c7777ef8f5)

## Check that your assistant uses it

Open **Helpdesk** > **Website assistant** and ask a question the article answers in **Try a question**. The answer says where it came from.

![Try a question: How long does shipping take? answered Every bag ships within 48 hours of roasting, with Answered from: Help article: How fast do you ship? outlined](https://mintcdn.com/locusdigital/Cbg2UXFY0C93pKnG/images/how-tos/helpdesk/kb-06-assistant-answers-closeup.webp?fit=max\&auto=format\&n=Cbg2UXFY0C93pKnG\&q=85\&s=55c098ebd878e99738b5aa7c8cbe56d3)

## Good to know

* **Change it any time.** Click the article in the list, then **Edit**, then **Save**. The chat and the assistant use the new text from then on.
* **One question per article.** Put the answer in the first sentence, and use the words your customers use.
* **More:** [Help articles](/helpdesk/knowledge-base) covers every setting, and [Teach Your Website Assistant](/how-tos/site-builder/teach-your-website-assistant) covers saved answers and business details.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.