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

# Drafts and versions

> Stage changes to your AI agent in a draft, publish them when they're ready, and go back to any saved version.

Changes to your AI agent are saved to a **draft** first. Your customers keep talking to the **live** agent until you **publish**. Every publish is saved as a **version**, so you can see what changed, compare versions, and restore an earlier setup.

## Save and publish

When you click **Save** on a page such as Instructions, Actions, Procedures, or a channel's settings, the change goes into your draft. Nothing changes for your customers yet.

The **Playground** always uses your draft, so you can try a change before anyone else sees it. Your chat widget, help page, and every other channel keep using the live agent.

When the draft is ready, click **Publish** in the top-right corner.

![The Publish button with its menu open: View pending changes, Commit version, Version history, and Discard changes](https://mintcdn.com/chatbase/7blSm5VgmZTd4l5Q/user-guides/chatbot/images/versions/publish-menu.png?fit=max\&auto=format\&n=7blSm5VgmZTd4l5Q\&q=85\&s=d621a79e1b638c27b8ef91b69e3eb8b7)

The Publish window shows everything your draft changes compared with what's live now, grouped by area: Agent, Channels, Actions, Widgets, and Procedures. In text such as instructions, only the words that changed are highlighted. Add an optional description, then click **Publish**. The change goes live immediately and is saved as a new version.

![The Publish this version window, showing an instructions change between Live now and Draft with the changed words highlighted](https://mintcdn.com/chatbase/7blSm5VgmZTd4l5Q/user-guides/chatbot/images/versions/publish-dialog.png?fit=max\&auto=format\&n=7blSm5VgmZTd4l5Q\&q=85\&s=31f6846d9e3a4ddf40a76bc6e304ab3d)

The arrow next to **Publish** opens more options:

| Option | What it does |
| - | - |
| **View pending changes** | Shows what your draft changes compared with live, without publishing. |
| **Commit version** | Saves your current setup as a version without making it live. Use it to keep a setup you might publish later. |
| **Version history** | Lists your recent versions. See [Version history](#version-history). |
| **Discard changes** | Throws away your unpublished changes, so your draft matches where it started. |

> [!NOTE]
>
> You need permission to edit the AI agent to publish, commit, or restore a version. Restoring a version that changes actions also needs permission to edit actions.

## Settings that go live right away

Some settings aren't part of the draft. They take effect as soon as you save them, and restoring a version never changes them:

* Data sources and training
* Connections to other apps and channels, such as WhatsApp, Messenger, Instagram, Slack, and Zendesk
* Turning a channel on or off
* Security settings, such as allowed domains, rate limits, and blocked senders
* Uploaded images, such as logos, avatars, and widget images
* The voice pronunciation dictionary

When a page has both kinds of setting, Chatbase lists the ones that will go live right away before it saves.

## Version history

Open the arrow next to **Publish** and click **Version history**. Each version shows:

* Its number and description
* When it was saved and who saved it
* The areas it changed
* **Live** on the version your customers are using now, and **Committed** on versions that were committed but never published

![The Version history panel listing versions 14 to 10, with version 14 marked Live and version 13 marked Committed](https://mintcdn.com/chatbase/7blSm5VgmZTd4l5Q/user-guides/chatbot/images/versions/version-history.png?fit=max\&auto=format\&n=7blSm5VgmZTd4l5Q\&q=85\&s=10e91005ed8b15a4c7c4bfa400aae73a)

### See what a version changed

Click a version to open its changes. Use **Compare to** to switch between:

* **Previous**: what this version changed compared with the version before it.
* **Live**: what would change if you restored this version now.

The icon at the top right of each change opens the page where that setting lives. For an action that still exists, it opens that action.

![The changes in version 12, compared to the previous version, with Restore at the top right](https://mintcdn.com/chatbase/7blSm5VgmZTd4l5Q/user-guides/chatbot/images/versions/version-changes.png?fit=max\&auto=format\&n=7blSm5VgmZTd4l5Q\&q=85\&s=3e65686956a3ce62e7a7382924bb08b6)

### Restore a version

Open the version and click **Restore**, then confirm. Restoring:

* Makes that setup live immediately.
* Saves it as a new version at the top of the history. Older versions stay where they are.
* Discards any unpublished changes in your draft.
* Keeps the restored version's description, or names it "Restored from" followed by the version number.

Your current plan and compliance settings still apply. If part of the old version isn't allowed anymore, for example a model your plan doesn't include or more enabled actions than your plan allows, Chatbase adjusts it and lists what didn't apply as saved. Widget images aren't restored.

If the newest version is a committed one that was never published, the button reads **Publish** instead of **Restore**.

## Changes made outside the dashboard

* **API**: updates through the Chatbase API go live immediately, without a draft, and appear in version history a minute or two later. They don't change your draft.
* **Backstage**: changes Backstage makes go into your draft, like your own. Backstage can also list your versions, show what restoring one would change, and restore it after you approve.


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