# Publishing and version history

> Understand the difference between your draft and what customers see, publish each channel, and roll back to an earlier version.

Your agent always has two sides: the draft you are working on, and the live version customers talk to. Publishing is how a draft becomes live. The **Deployments** page keeps a history of every time you published, so you can see what changed and go back if something goes wrong.

**Where to find it:** open your agent and select **Deployments** in the sidebar. You publish from the **Playground**.

![The Deployments page listing numbered versions for Chat Bubble, WhatsApp, Instagram, and Slack, with In production and Promote labels](https://hourzero.dev/marketing/app/deployments-light.webp "Each row is one publish. The badge shows which version each channel uses right now.")

## Draft and live, in plain words

Think of a document you are writing. Saving keeps your changes, but nobody else sees them. Sending it is what puts it in front of other people. Hourzero works the same way:

- **Saving** keeps your changes in the draft. You can test the draft in the Playground. Customers never see it.
- **Publishing** sends a copy of the saved draft to one channel. From that moment, customers on that channel get the new version.

1. **Edit**: Change instructions, knowledge, or channel settings.
2. **Save**: Your changes are kept in the draft.
3. **Test**: Try the draft in the Playground.
4. **Publish**: Copy the draft to one channel for customers.

After you publish, you keep editing the same draft. Your next changes stay private until you publish again.

> [!TIP]
> Editing the draft is safe. You can rewrite instructions or try a new model, test it in the Playground, and customers keep getting the old version until you choose to publish.

## Each channel is published separately

Every channel has its own live version. When you publish the Chat Bubble, only the Chat Bubble changes. WhatsApp, Instagram, Slack, and your other channels keep the version they had.

This is useful when you want to try a change in one place first. For example, Acme updates its return instructions and publishes them on the Chat Bubble. After a day of good answers, Maya Chen publishes the same draft to WhatsApp and Instagram.

> [!IMPORTANT]
> Changes to shared things, like instructions, data sources, or the model, only reach a channel when you publish that channel. If you want a change everywhere, publish each channel.

## What a published version includes

When you publish, Hourzero saves a full copy of everything that channel needs:

- your instructions, guardrails, and model;
- the knowledge from your latest training;
- your actions, skills, and procedures, and which of them the channel may use;
- the channel's look and settings, like its display name, welcome message, and allowed websites;
- whether **Agent replies** is on or off for that channel.

> [!NOTE]
> Published versions use the knowledge from your most recent training. If you added or changed data sources, retrain before you publish. See [Data sources](https://hourzero.dev/docs/ai-agent-management/data-sources).

## Publish a channel

1. Make your changes and select **Save draft** in the Playground.
2. If you changed your data sources, retrain the agent.
3. Test the draft in the Playground preview.
4. Pick the channel you want to publish from the channel menu.
5. Select **Publish** at the top right, then choose the option for that channel. For Chat Bubble and Center Stage it is **Website widget**. For Chat Iframe and the messaging channels it is the channel name, like **Chat Iframe** or **WhatsApp**.
6. Review the dialog. Website channels need at least one allowed domain. Messaging channels show whether the connection is ready.
7. Select **Publish saved draft**. If the channel was published before, the button says **Publish latest draft**. If the agent has a [release suite](https://hourzero.dev/docs/ai-agent-management/benchmarks#check-every-release-with-a-release-suite), select **Check and publish** first, then **Publish** once the check shows no answer got worse.

A message confirms the channel is published, and a new row appears on the **Deployments** page with the badge **In production**.

> [!NOTE]
> Only saved changes get published. If you have unsaved changes, the publish button in the dialog stays turned off until you select **Save draft**.

## Read the version history

Each row on the **Deployments** page is one publish, numbered in order: **Deployment #1**, **Deployment #2**, and so on.

- **Channel** shows which channel the version was published to.
- **Created** shows when it happened.
- **Status** shows **In production** for the version a channel uses right now, and **Not in production** for older ones.
- Under the number, **Published** means it came from the Playground. **Promoted** means someone rolled back to it.

Use the **Channel**, **Type**, and **Status** filters above the list to narrow it down. Select **Clear filters** to see everything again.

## Look at an old version

Select a deployment number to open it. The page shows exactly what that channel was using:

- **Channels**: the channel's settings at the time, and whether replies were turned on;
- **Instructions and model**: the instructions, guardrails, and model settings;
- **Data sources**: the files, pages, and notes the agent knew;
- **Skills**, **Actions**, and **Procedures**: what the agent could do.

This is the place to answer "what was WhatsApp actually using last Tuesday?" when a customer reports a strange answer.

## Roll back to an earlier version

If a new version causes problems, you can put an earlier one back. Hourzero calls this **Promote**.

1. On the **Deployments** page, find the earlier version you want. Use the **Channel** filter to show only that channel.
2. Select the deployment number and check the details.
3. Select **Promote**.
4. If the version covers more than one channel, choose the channel.
5. Select **Promote to production**.

The change happens right away. Customers on that channel get the earlier version, and a new row marked **Promoted** appears at the top of the history.

> [!IMPORTANT]
> Rolling back doesn't touch your draft. The draft may still contain the change that caused the problem. Fix it in the Playground and test it before you publish again.

### When you can't roll back

Hourzero can't promote a version if something it relies on is gone. You see an error message when:

- an action, skill, procedure, or data source it uses was deleted;
- the app account it used, like a WhatsApp number or Slack workspace, was disconnected;
- that version is already the one in production on that channel;
- the agent is archived.

If that happens, fix the draft and publish a new version instead.

## Take a channel offline

To stop a channel from serving customers completely, unpublish its live deployment.

1. On the **Deployments** page, find the deployment marked **In production**. Use the **Channel** filter to show only that channel.
2. Select **Unpublish**. You can also open the deployment and select **Unpublish** there.
3. Select **Unpublish** in the dialog to confirm.

The channel goes offline right away. On a website, visitors can no longer start a chat. On messaging channels, the agent stops answering. Your other channels keep their live versions.

The deployment stays in the history, marked **Not in production**. To bring the channel back, publish it from the Playground or promote any deployment for that channel.

> [!NOTE]
> Unpublishing doesn't change your draft or disconnect app accounts, like a WhatsApp number or Slack workspace. It only takes the published version off the channel.

## Common questions

### Do customers see my changes when I select Save draft?

No. Saving only changes the draft. Customers see changes after you publish the channel.

### Why does WhatsApp answer differently from my website chat?

The two channels are probably on different versions. Check the **Deployments** page to see which version each channel is using, then publish the channel that is behind.

### How do I stop the agent on one channel?

Unpublish the channel's live deployment on the **Deployments** page. See [Take a channel offline](#take-a-channel-offline). You can also turn off **Agent replies** for that channel in the Playground, save, and publish. See [Channels](https://hourzero.dev/docs/ai-agent-management/channels) for the steps.

## Next steps

- [Playground](https://hourzero.dev/docs/ai-agent-management/playground): Test your draft and style each channel before you publish.
- [Channels](https://hourzero.dev/docs/ai-agent-management/channels): Connect WhatsApp, Instagram, Slack, and more.
- [Website widget](https://hourzero.dev/docs/integrations/website-widget): Add the Chat Bubble to your website.
- [Chat Iframe](https://hourzero.dev/docs/integrations/chat-iframe): Embed a full-size chat inside a page of your website.
- [Conversations](https://hourzero.dev/docs/ai-agent-management/conversations): Check that live chats work after you publish.
