# Publish a version

Publishing turns the draft of a Web Agent into the next numbered version. The release target serves the new version as soon as the publish finishes. Other environments keep the version they serve.

## Before you begin

- The draft has unpublished changes. The agent's header shows `Draft v4 · unpublished changes`, with the number the version will get. **Publish** is not available while the draft matches the latest version.
- You know which environment is the release target. The header marks it in the list of environments. On a new agent it is the first environment you selected in the wizard.

## Publish the draft

> **Warning:** If the release target is Production, your users get the new version on their next page load. To try versions first, make another environment the release target. See [Deploy a version to an environment](https://docs.faustine.ai/web-agents/deploy-a-version/).

To publish:

1. In the portal, go to [**Web Agents**](https://auth.faustine.ai/go?to=%2Fweb-assistants) and select your agent.
2. In the agent's header, select **Publish**.

The header shows the draft with the next number and `no changes`, and the release target shows the version you published. The **Versions** tab lists the new version with a **Live on** badge for the release target.

A version cannot be edited. To change something, change the draft and publish again.

![The Versions tab after three publishes. The newest version is live on Production.](https://docs.faustine.ai/images/web-agents/versions-light.png)

## Deploy the version to other environments

A publish does not change what the other environments serve. To serve the new version on them, see [Deploy a version to an environment](https://docs.faustine.ai/web-agents/deploy-a-version/).

## Troubleshooting

| Symptom | Cause | Fix |
| --- | --- | --- |
| **Publish** is not available | The draft matches the latest version. | Change something in the agent first. |
| `Variable "…" has no value in release-target environment "…" and no defaultValue` | An action reads a variable that has no default and no value on the release target. | Set the value in the **Variables** tab. See [Set variables for each environment](https://docs.faustine.ai/web-agents/variables/). |
| The header shows a version as published and a **Deploy** button for the release target | The release target serves an earlier version, for example after a rollback. | Select the button to serve the latest version there. |
| The site still shows the previous version | The page loads an environment that is not the release target. | Deploy the version to that environment. |

## Next steps

- [Deploy a version to an environment](https://docs.faustine.ai/web-agents/deploy-a-version/): serve the version on the other environments.
- [Roll back to an earlier version](https://docs.faustine.ai/web-agents/roll-back/): serve the previous version again.
- [Versions, environments and deployments](https://docs.faustine.ai/web-agents/versions-and-environments/): what a version contains.