---
schema_version: "1"
id: 5b639bdfef2e7577bb8f07f0193262994c039f61c097542f8aab8b1cc85a2dcf
title: Manage Agent Versions in the Legacy Builder
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/ai/264-0-0/agent_versions.md
canonical_url: https://help.salesforce.com/s/articleView?id=ai.agent_versions.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: f3267868f78f31930f809484fe08a7486abea4ac89aa75b630dc26c45e623b48
description: Create multiple versions of an agent to make and test changes without taking the active version out of production. Or create a version to save as a backup, so you can quickly revert to a previous version. When you create a new version of an agent, Salesforce creates independent copies of the agent's subagents, actions, and other assets. Every agent and agent version has its own assets, and assets aren't shared.
products:
  - Agentforce
  - Cross Cloud
release: "264"
---
# Manage Agent Versions in the Legacy Builder

Create multiple versions of an agent to make and test changes without taking the active version out of production. Or create a version to save as a backup, so you can quickly revert to a previous version. When you create a new version of an agent, Salesforce creates independent copies  of the agent's subagents, actions, and other assets. Every agent and agent version has its own assets, and assets aren't shared.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Enterprise</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, and <strong>Developer</strong> Editions. <a href="https://help.salesforce.com/s/articleView?id=ai.agent_setup_explore_types.htm&amp;release=264.0.0&amp;type=5" title="Learn about agent types and default templates for specific clouds and common use cases.">Required add-on licenses vary by agent type.</a></td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d56113e72">User Permissions
              Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d56113e72 ">To manage versions of AI agents:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d56113e72 ">Manage AI Agents AND <a href="https://help.salesforce.com/s/articleView?id=ai.agent_setup_explore_types.htm&amp;type=5&amp;language=en_US" target="_blank">the required permissions for your agent
                type</a></td>

          </tr>
        </tbody>
      </table>

You can create up to 20 versions of an agent. Only one version of an agent can be active at a time. If you’ve reached the limit, delete older versions before cloning new ones.

If cloning fails, check that you’re not at the 20-version limit, that you’ve saved all changes, and that you have the correct permissions.

When you clone a version of an agent, its assets are also cloned, so that every agent and agent version has its own assets. These assets include:

- [System messages](https://help.salesforce.com/s/articleView?id=ai.copilot_setup_system_messages.htm&release=264.0.0&type=5 "Agent-level instructions provide your agent with guidance on how to interact in all situations, including any rules it should follow. Your agent sends system messages, such as welcome and error messages, when your users begins chatting with an agent and if they encounter system errors.")
- Subagents, including standard subagents and [customizations you've made to standard subagents](https://help.salesforce.com/s/articleView?id=ai.copilot_topics_edit.htm&release=264.0.0&type=5 "Edit an out-of-the-box subagent to make sure it meets the needs of your specific use case and respects the right guardrails for your business.")
- Actions, including [standard actions](https://help.salesforce.com/s/articleView?id=ai.copilot_actions_add.htm&release=264.0.0&type=5 "To use an action with an agent, add it to a subagent. An action can be added to multiple subagents. When you add a subagent to an agent, Salesforce makes a copy of the subagent and its actions. Each agent and agent version has its own independent copy of subagents and actions.") and [custom agent actions](https://help.salesforce.com/s/articleView?id=ai.copilot_actions_custom.htm&release=264.0.0&type=5 "With custom actions, you can extend your agent with Salesforce functionality so that it’s ready to assist users with tasks specific to your business. Build custom actions using Apex, flows, prompt templates, and API integrations.")
- [Filters](https://help.salesforce.com/s/articleView?id=ai.agent_asset_filters.htm&release=264.0.0&type=5 "Create filters for subagents and actions to make sure that your agent can use them in a conversation only when certain conditions are met. You can limit access based on any variable you specify. For agents on customer channels, we recommend using filters to require authentication for subagents and actions that perform tasks for a user.")
- [Custom variables, output mappings, and input assignments](https://help.salesforce.com/s/articleView?id=ai.agent_variables_create.htm&release=264.0.0&type=5 "Control how an agent uses subagents and actions by mapping an action output to a custom variable. For example, when you assign a variable to an action input, your agent can use only the assigned variable to fill the value of the input.")

Versioning of standard and custom subagents and actions isn’t currently supported. Changes you make to a custom subagent or action apply to only the agent and version to which they’re assigned.

Each new agent version, including the agent version's assets, is an independent copy of the version you cloned.

1. From the Agentforce Agents Setup page, in the list of agents, expand the agent row to see its versions. Click the dropdown for the agent you want to clone or delete.
2. To create an agent version, from the right dropdown for the version you want to duplicate, select **Clone Version**. To delete an agent version, select **Delete**.

You can quickly switch between agent versions in Agentforce Builder and on the Details page for your agent.

#### See Also

- [_Video_: Use Versions to Deploy Agentforce Agents with Zero Downtime](https://youtu.be/wguiOv24_Ek)