---
schema_version: "1"
id: bb36800df611189ebbbbe4092f8b22ebeac95ac873f2a18f182de4030cdd0554
title: Swap a Development Environment
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/devops_center_dev_environment_swap.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.devops_center_dev_environment_swap.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: c7d22ee6baa8c734d12957ef56ed596a7b597d7cfe7ce8eb0a965e9a01f42fa6
description: Swap a development environment with another development environment. If your development environment is a Developer or Developer Pro sandbox that was recently refreshed, the connection to the existing environment is no longer valid. You must swap the sandbox to reestablish the connection to it in DevOps Center.
products:
  - Salesforce Platform
release: "264"
---
# Swap a Development Environment

Swap a development environment with another development environment. If your development environment is a Developer or Developer Pro sandbox that was recently refreshed, the connection to the existing environment is no longer valid. You must swap the sandbox to reestablish the connection to it in DevOps Center.

### 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="d34104e27">Permission Sets Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Permission Sets Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d34104e27 ">To swap an environment:</td>
            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d34104e27 ">DevOps Center Manager</td>
          </tr>
          <tr class="">
            <td data-label="Permission Sets Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d34104e27 ">To access the named credentials required to authenticate to the environment:</td>
            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d34104e27 ">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 your production (release environment), or cloned from a pipeline stage or an existing development environment.

Before you swap the dev environment, keep these things in mind:

- We recommend that you promote all work items before refreshing the sandbox.
- When you refresh the sandbox, you lose any changes in the current environment that weren’t pulled and committed to work item feature branches in the source control repository.
- Any changes in the old sandbox that were pulled and committed, but not promoted, are in the work item’s feature branch but aren’t visible in the new sandbox. To view the committed changes in the new sandbox, promote the affected work items and then perform a sync from the first pipeline stage’s branch back to the sandbox. See [Synchronize Your Development Environment](https://help.salesforce.com/s/articleView?id=platform.devops_center_dev_environment_sync.htm&release=264.0.0&type=5 "If you’re working on a team with multiple developers, it’s likely that your dev environment is going to become out of sync with the source control repository. DevOps Center tracks the differences between each development environment and the first pipeline stage’s branch.") for details.
- The DevOps Center connection to the current environment is no longer usable.
- The new dev environment must have source tracking enabled.

1. In the Pipeline Environments tab, select **Swap Environment** from the environment’s menu.
2. Click **I Understand** to acknowledge the considerations, then click **Continue**.
3. Select **Log In to New Environment**, then click **Log In**.
4. Complete the login process.

After the swap is complete, check to see if the development environment is out of sync. If so, we recommend synchronizing the environment before continuing work.

#### See Also

- [_Salesforce DX Developer Guide_: Enable Source Tracking in Sandboxes](https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_setup_enable_source_tracking_sandboxes.htm)