> For the complete documentation index, see [llms.txt](https://docs.artific.nl/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.artific.nl/en/for-administrators/assistants/preview-and-embedding.md).

# Preview and embedding

How to try an assistant before releasing it, and how to put it on a website.

## Preview

The **Preview** tab shows the assistant exactly as a user will see it, using its own theme, colours and logo. It runs in a separate conversation from your normal chat, so testing here does not clutter your own history.

Use it after every meaningful change to the instructions, knowledge or tools.

### What to test

Do not only ask the questions the assistant is designed for. Also ask:

| Question type                                   | What you are checking                                   |
| ----------------------------------------------- | ------------------------------------------------------- |
| A question it should answer well                | The basics work, and the answer cites the right source. |
| A question just outside its scope               | It declines gracefully instead of inventing an answer.  |
| A question that needs a tool                    | The tool actually fires.                                |
| A vague, badly-phrased question                 | It asks for clarification instead of guessing.          |
| A question about something not in the documents | It says it does not know, and points somewhere useful.  |

The last one matters most. An assistant that confidently invents an answer is worse than no assistant, and you will only find out by trying.

## Embedding an assistant on a website

The **Embed assistant** button, at the top of the settings area, generates the code to put this assistant on any web page. It offers two forms.

### Corner widget

A small launcher button in the corner of the page, which opens a chat panel when clicked. This is the usual choice for a support assistant on a public website. It is available on every page without taking any space.

Copy the snippet and paste it into your site's HTML, before the closing `</body>` tag.

### Full page

An embedded frame that fills whatever space you give it. Use this for a dedicated "Ask our assistant" page, or inside an intranet portal.

Copy the snippet and paste it where the chat should appear. Give the surrounding element a real height, or the frame will collapse.

{% hint style="info" %}
The generated code contains the identifiers for your organisation and this assistant. Anyone who can view your web page can see it, so only embed assistants you are happy to expose to that page's audience. For anything internal, use **Authentication needed** so only signed-in people can chat.
{% endhint %}

### Before you embed

1. **Set the theme.** The embedded widget uses the assistant's theme, not your organisation's brand settings. See [Themes](/en/for-administrators/assistants/themes.md).
2. **Decide about authentication.** With **Authentication needed** on, only signed-in users can use the widget. With it off, anyone who reaches the page can.
3. **Check the opening message and suggested questions.** On a public site these are the whole first impression.
4. **Set the resume deadline.** **Deadline for resuming a session** in [Advanced settings](/en/for-administrators/assistants/advanced-settings.md) controls how long a visitor can leave and come back to the same conversation. It only applies to embedded assistants.
5. **Turn the assistant on.** A disabled assistant shows an error in the widget.

### If voice is enabled

The embed code already asks the browser for microphone access. The page hosting the widget must also allow it, or the microphone stays blocked. The widget explains this to the user when it happens.

## What visitors see when something is wrong

| Message                         | Cause                                                              |
| ------------------------------- | ------------------------------------------------------------------ |
| **No access**                   | The visitor is not allowed to use this assistant.                  |
| **Assistant is disabled**       | **Assistant visible to users** is off.                             |
| **No session**                  | The visitor cannot start a conversation, usually a rights problem. |
| **Error loading the assistant** | Something went wrong loading it; reloading the page usually helps. |