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

# Help Center

> Add a Help tab to your chat widget where visitors browse and search your help articles

The Help Center adds a third tab to the footer of your chat widget, next to **Home** and **Messages**. Visitors use it to browse help articles, search them, and read the answer without starting a chat. If they still need help, they click **Ask a question** to start a chat with your chatbot.

You write and organize the content in the dashboard. You can also ask the BubblaV Assistant to do it for you.

## Turn On the Help Center

The Help Center tab is off by default.

**1. Open Design**

Go to [bubblav.com/dashboard](https://www.bubblav.com/dashboard), select your website, and click **Design** in the sidebar menu.

**2. Open the Help Center section**

Expand the **Help Center** section. It sits between **Chat Screen** and **Advanced Settings**.

**3. Show the tab**

Turn on **Show Help Center tab**. The setting saves automatically, with no **Save** button.

**4. Check the live site**

The tab appears on your live site within a minute. In rare cases, caching can delay it by up to 5 minutes.

> [!NOTE]
>
> The tab shows in the widget when **Show Help Center tab** is on. A visitor sees only **published** content. If you turn the tab on and publish nothing, the tab opens with no articles. Add and publish at least one article.

### Tab Label and Languages

By default, the tab is named **Help**. The widget translates this default into the language you choose under **Widget Language** in [Widget Design](/user-guide/widget-design.md).

To use your own name, such as "Support" or "FAQ", type it in **Tab label** (up to 80 characters; the field shows "Help" as the placeholder). Your own label stays as you wrote it in every language. Leave the field empty to go back to the translated default. The label saves automatically.

You can also edit the label in the live preview. Click the Help tab in the preview, change the label, and click **Save** in the inline editor.

## Groups and Articles

The Help Center has two kinds of content:

* **Groups**: folders that hold articles. Groups have one level only. A group cannot contain another group.
* **Articles**: the help content. An article sits inside a group or at the top level (select **None (top level)** for **Group**).

Visitors see your groups and your top-level articles on the first screen of the tab.

### Add a Group

1. In the **Help Center** section, enter a name in **New group title** (up to 80 characters).
2. Click **Add group**.

New groups go to the end of the list. Each group row shows its article count. Use the buttons on the group row to publish or unpublish it (**Publish** / **Unpublish**), rename it (pencil icon), delete it (trash icon), or move it up or down (arrows). Top-level articles are listed under **Top level**. Group and article changes save at once.

### Add an Article

1. Click **Add article** at the top of the section, or open a group and click **Add article to this group**.
2. Fill in the article dialog:
   * **Title**: up to 200 characters.
   * **Type**: **Text article** or **Link (opens in a new tab)**.
   * **Content** (text articles) or **URL** (link articles).
   * **Group**: the group that holds the article. Select **None (top level)** for the top level.
   * **Status**: **Published** or **Draft (hidden from visitors)**.
3. Click **Save** in the dialog. The article is saved at once.

### Text Articles and Link Articles

| Type | What you provide | What the visitor sees |
| :- | :- | :- |
| **Text article** | Content in the markdown editor (up to 50,000 characters). The editor supports bold, italic, links, and lists. | The article opens inside the widget. A back button returns the visitor to the group or to the first screen. |
| **Link** | A URL that starts with `http://` or `https://` (up to 2,048 characters). | The article list shows it with an external-link icon. The page opens in a new browser tab. The widget stays open. |

Use a link article when the answer already exists on your website, for example a shipping policy page or a page in your own documentation.

### Draft and Published

Every group and every article has a status:

* **Published**: visitors can see it in the widget.
* **Draft**: only you can see it in the dashboard. Visitors never see it.

Use **Publish** and **Unpublish** on a row to change the status without opening the article.

> [!WARNING]
>
> A draft group hides all of its articles from visitors, even when the articles are published. To show the articles again, publish the group.

A group with no published articles does not show in the widget. It shows again when you publish an article in it.

### Order

Visitors see groups and articles in the same order as the dashboard. Use the up and down arrows on a row to move it. New groups and new articles go to the end. When you move an article to another group, it goes to the end of that group.

### Delete

* **Delete an article**: removes the article. Confirm in the dialog.
* **Delete a group**: removes the group **and all the articles inside it**. Confirm in the dialog. This cannot be undone. To keep the articles, move them to another group or to the top level first, or unpublish the group instead.

## What Visitors See

**1. Open the tab**

The visitor clicks the Help tab in the widget footer.

**2. Search or browse**

The visitor types in the search box to find articles, or browses the groups and top-level articles.

**3. Read**

A group opens to show its articles. A text article opens in the widget. A link article opens in a new browser tab. The back button returns to the group or to the first screen.

**4. Ask a question**

The visitor clicks **Ask a question** to start a chat with your chatbot.

Search runs in the visitor's browser on your published articles. It does not use a chat message from your plan quota.

## Google Analytics Events

When the [Google Analytics 4](/user-guide/integrations/google-analytics.md) integration is on, the widget sends these Help Center events:

| Event | When it fires |
| :- | :- |
| `bubblav_help_center_opened` | A visitor opens the Help tab. |
| `bubblav_help_center_closed` | A visitor leaves the Help tab for another tab. |
| `bubblav_help_group_opened` | A visitor opens a group. |
| `bubblav_help_article_opened` | A visitor opens an article from browsing or from search results. |
| `bubblav_help_search_query` | A visitor presses Enter in the search box, or leaves the search box, with a new search text. |
| `bubblav_help_ask_clicked` | A visitor clicks **Ask a question** in the Help tab. |

See the [event reference](/user-guide/integrations/google-analytics.md#help-center-events) for the properties of each event.

## Manage the Help Center with Ask BubblaV

You do not need to open the Design page. Ask the [BubblaV Assistant](/user-guide/help-assistant.md), or a connected AI client such as Claude or ChatGPT through the [MCP server](/developer-guide/mcp-server.md), to manage the content. Example prompts:

```text theme={null}
Turn on the Help Center tab and name it "Support".
```

```text theme={null}
Create a group called "Shipping" and add a text article named "How long does delivery take?" with our delivery times.
```

```text theme={null}
Add a link article named "Return policy" that points to https://example.com/returns, in the "Orders" group. Keep it as a draft.
```

```text theme={null}
Show me everything in my Help Center, including drafts.
```

```text theme={null}
Move the "Shipping" group to the top, and publish the "Return policy" article.
```

The assistant asks for your approval before it deletes a group or an article.

## Troubleshooting

> **The Help tab does not appear in the widget**
>
> * Open **Design -> Help Center** and turn on **Show Help Center tab**. The change saves automatically.
> * Reload your site. Changes usually appear within a minute (up to 5 minutes if caching has not cleared).

> **An article does not appear for visitors**
>
> * Check that the article status is **Published**, not **Draft**.
> * If the article is in a group, check that the group is **Published**. A draft group hides all of its articles.
> * Check that **Show Help Center tab** is on.
> * Reload your site. Changes usually appear within a minute.

> **My link article opens in a new tab**
>
> This is expected. Link articles always open in a new browser tab so the visitor keeps the widget open.

> **I deleted a group by mistake**
>
> Deleting a group also deletes its articles, and this cannot be undone. Add the group and the articles again. To avoid this, unpublish a group instead of deleting it.

## Next Steps

> **[Widget Design](/user-guide/widget-design.md)**
>
> Colors, position, languages, and the other design settings

> **[Google Analytics](/user-guide/integrations/google-analytics.md)**
>
> Track how visitors use the Help Center


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