Loading
Agentforce is temporarily unavailable. Please try again later or visit Help topics below. For additional support, please contact your local support number for assistance. Thank you!
Ongoing maintenance for Salesforce HelpRead More
Salesforce Enforces New Security Requirements in Summer 2026Read More
Manage and Release Changes Easily and Collaboratively with DevOps...
Replace a Development Environment

You are here:

  1. Salesforce Help
  2. Docs
  3. DevOps Center

Replace a Development Environment

After a Developer or Developer Pro sandbox refreshes or a scratch org expires, the connection to DevOps Center becomes unusable. Replace the development environment in the next-generation DevOps Center to restore the connection. DevOps Center deploys the pipeline stage branch to the new sandbox so that you can continue working with the correct metadata and configuration data.

Required Editions

Available in: Lightning Experience in Professional (API access required), Enterprise, Performance, Unlimited, and Developer Editions
Not available in: Government Cloud Plus. Contact your Salesforce account executive for more details.
Not available in: EU Operating Zone. EU Operating zone is a special paid offering that provides an enhanced level of data residency commitment. DevOps Center is supported in orgs in the EU that aren’t part of EU OZ, per standard product terms and conditions.
User Permissions Needed
To replace an environment: DevOps Center Admin
To access the named credentials required to authenticate to the environment: Access DevOps Center Named Credentials
Important
Important We recommend refreshing sandboxes from the production (release) environment, or cloning them from a pipeline stage or an existing development environment.

Before you replace a development environment, review the considerations, and make sure that the new development environment has source tracking enabled. See Replace and Connect a New Environment.

Note
Note In DevOps Center (Managed Package), this operation is called swap environment.
  1. Go to the DevOps Pipelines tab, and select your pipeline.
  2. Click the down arrow icon under Approved Work Items, and then select Replace Environment.
  3. Review the considerations, select the confirmation checkbox, and then click Continue.
  4. Select an environment, and then click Log In.
  5. Complete the login process.
    DevOps Center replaces the environment. Check whether the development environment is out of sync. If it is, sync it before you continue work. See Keep Your Development Environment in Sync.

See Also

 
Loading
Salesforce Help | Article