---
schema_version: "1"
id: 851224c6ea25c72d004b81000e8848016c4da945d67e25d7d89ad25732f0486c
title: Remove a Subagent from Your Agent
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/ai/264-0-0/agent_topics_remove.md
canonical_url: https://help.salesforce.com/s/articleView?id=ai.agent_topics_remove.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 702cd2bd7229aeabfd31def0a98fcb9f95a12d383bac9d722dd0fec5238ec93b
description: Make sure that your agent continues to deliver helpful and relevant responses by removing subagents you no longer need.
products:
  - Agentforce
  - Cross Cloud
release: "264"
---
# Remove a Subagent from Your Agent

Make sure that your agent continues to deliver helpful and relevant responses by removing subagents you no longer need.

### 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>

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/images/icon_note.png)

Note Beginning in April 2026, agent topics are now called subagents. There are no changes to functionality. During this transition, you may see a mix of the new and previous terms in our documentation.

<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="d121912e78">User Permissions
              Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d121912e78 ">To remove a subagent from an agent:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d121912e78 ">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>

To make changes to your agent, it must be in a draft state. If you want to make changes to a committed agent version, [create a draft](https://help.salesforce.com/s/articleView?id=ai.agent_versions_draft.htm&release=264.0.0&type=5 "Create multiple versions of an agent to seamlessly iterate on your agent’s design. Create a version to experiment with different instructions, subagents, or actions and preserve your current configuration. Or create a version to save as a backup, so you can revert quickly.").

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/images/icon_note.png)

Note

These steps cover how to remove a subagent from an agent in Canvas view, but there are a few ways to remove a subagent in Agentforce Builder.

- Ask Agent Optimizer to remove a subagent for you. You can accept or decline any changes.
- Remove the subagent in Script view.

1. From the Agents list in the Agentforce Studio app, open the agent you want to remove a subagent from.
2. From the Explorer panel, under Subagents, hover over the subagent you want to remove from your agent.
3. Click ![Ellipsis menu icon](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/generative_ai/images/agent_builder_ellipsis_menu.png), and then click **Delete**.
4. Delete any references to the subagent from other subagents, including the Agent Router.
    
    The subagent is automatically removed from the Agent Router's reasoning actions.
5. Save your changes.

The subagent and any associated actions are removed from your agent, and any customizations you made to the subagent are deleted. If you added the subagent to your agent from the asset library, an independent copy of that subagent was added to your agent. Removing the subagent from your agent doesn’t delete the subagent from the asset library.