---
schema_version: "1"
id: f26f35462389f02cba075bc5f2133913ed317dd42b647da03fd436f3a2c6fb96
title: Swap a Pipeline Environment
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/devops_center_pipeline_environment_swap.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.devops_center_pipeline_environment_swap.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 84d73ec9c8bb09365c45881bb3530e0fd9e3a4ec221039374a2da8f56e4d7c02
description: Swap a pipeline environment with another environment. If the pipeline environment is a sandbox that was recently refreshed, you must swap it before anyone can promote changes to the associated pipeline stage. The DevOps Center connection to the current environment is no longer usable.
products:
  - Salesforce Platform
release: "264"
---
# Swap a Pipeline Environment

Swap a pipeline environment with another environment. If the pipeline environment is a sandbox that was recently refreshed, you must swap it before anyone can promote changes to the associated pipeline stage. The DevOps Center connection to the current environment is no longer usable.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:47.393364928909946%">
          <col style="width:52.60663507109005%">
        </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="d31161e27">Permission Sets Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Permission Sets Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d31161e27 ">To swap an environment:</td>
            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d31161e27 ">DevOps Center Manager</td>
          </tr>
          <tr class="">
            <td data-label="Permission Sets Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d31161e27 ">To access the named credentials required to authenticate to the environment:</td>
            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d31161e27 ">sf_devops_InitializeEnvironments</td>
          </tr>
        </tbody>
      </table>

![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-devops_center-264-0-0-production-enus/166010c3-4c34-4087-92ad-aea917baf524/images/icon_important.png)

Important We recommend that all sandboxes are refreshed from the production (release environment), or cloned from a downstream pipeline stage.

1. In the Pipeline Environments tab, select **Swap Environment** from the environment’s menu.
2. To acknowledge the considerations, click **I Understand**, then **Continue**.
3. Select **Log In to New Environment**, then click **Log In**.
4. Complete the login process.
    
    The pipeline stage is disabled until the deployment is completed.
    
    - If DevOps Center can determine that the environment was descended from an environment in the project pipeline, all work items that are connected to the current pipeline environment are moved to the new pipeline environment.
    - If DevOps Center can’t determine that the environment’s ancestry, DevOps Center deploys all changes from the pipeline stage’s branch to the new pipeline environment. This operation can take a while.