Loading
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 Pipeline Environment

Replace a Pipeline Environment

Activating a refreshed sandbox permanently deletes the original environment and its data, which breaks the connection to DevOps Center. Replace the pipeline environment in the next-generation DevOps Center before your team members promote changes to the associated pipeline stage. DevOps Center deploys changes from the pipeline branch to the new environment.

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 downstream pipeline stage.

Before you replace a pipeline environment, review the considerations. 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 on the required pipeline stage, 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 disables the pipeline stage until the deployment completes.
 
Loading
Salesforce Help | Article