---
schema_version: "1"
id: e0246566d500db1aacc732d9189c29f4442e61b487e3cf877ebeaced37946f2d
title: Replace and Connect a New Environment
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/devops_center_replace_connect_environment.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.devops_center_replace_connect_environment.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 03d529bc882ecbbc7de5a9595699572d368b024173ba5f27bebbf3ee7edca101
description: Maintain pipeline integrity by replacing an expired, deleted, or refreshed development or pipeline environment in Lifecycle Center. When you connect a new environment, Lifecycle Center restores the complete branch state, including metadata and configuration data, to keep it in sync with the pipeline.
products:
  - Salesforce Platform
release: "264"
---
# Replace and Connect a New Environment

Maintain pipeline integrity by replacing an expired, deleted, or refreshed development or pipeline environment in Lifecycle Center. When you connect a new environment, Lifecycle Center restores the complete branch state, including metadata and configuration data, to keep it in sync with the pipeline.

### 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 in <strong>Professional</strong> (API access required), <strong>Enterprise</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, and <strong>Developer</strong> Editions</td></tr></tbody><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Not available in: <strong>Government Cloud Plus</strong>. Contact your Salesforce account executive for more details.</td></tr></tbody><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Not available in: <strong>EU Operating</strong> Zone. EU Operating zone is a special paid offering that provides an enhanced level of data residency commitment. Lifecycle Center <em>is</em> supported in orgs in the EU that aren’t part of EU OZ, per standard product terms and conditions.</td></tr></tbody></table>

## Considerations Before Replacing an Environment

- Promote all work items before you refresh the sandbox.
- Make sure that the new development environment has source tracking enabled.
- When you refresh the sandbox, you lose changes in the development environment that weren't pulled and committed to work item feature branches.
- Committed but unpromoted changes remain in the feature branch but don't appear in the new sandbox. To see them, promote the work items and then sync from the first pipeline stage branch back to the sandbox. See [Keep Your Development Environment in Sync](https://help.salesforce.com/s/articleView?id=platform.devops_center_sync_dev_environment.htm&release=264.0.0&type=5 "Use back sync to update your development environment with the latest changes from the first pipeline stage. Keeping your environment current helps maintain compatibility with your team’s changes and reduce merge conflicts.").
- Lifecycle Center pauses the pipeline stage activities during the replacement to prevent conflicts. You can't promote or run back sync until the new environment is fully deployed and verified.

![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 refreshing sandboxes from the production (release) environment, or cloning them from a pipeline stage or an existing development environment.

- **[Replace a Development Environment](https://help.salesforce.com/s/articleView?id=platform.devops_center_replace_dev_environment.htm&release=264.0.0&type=5)**  
    After a Developer or Developer Pro sandbox refreshes or a scratch org expires, the connection to Lifecycle Center becomes unusable. Replace the development environment in Lifecycle Center to restore the connection. Lifecycle Center deploys the pipeline stage branch to the new sandbox so that you can continue working with the correct metadata and configuration data.
- **[Replace a Pipeline Environment](https://help.salesforce.com/s/articleView?id=platform.devops_center_replace_pipeline_environment.htm&release=264.0.0&type=5)**  
    Activating a refreshed sandbox permanently deletes the original environment and its data, which breaks the connection to Lifecycle Center. Replace the pipeline environment in Lifecycle Center before your team members promote changes to the associated pipeline stage. Lifecycle Center deploys changes from the pipeline branch to the new environment.

#### See Also

- [Keep Your Development Environment in Sync](https://help.salesforce.com/s/articleView?id=platform.devops_center_sync_dev_environment.htm&release=264.0.0&type=5 "Use back sync to update your development environment with the latest changes from the first pipeline stage. Keeping your environment current helps maintain compatibility with your team’s changes and reduce merge conflicts.")
- [Are You Sharing a Development Environment?](https://help.salesforce.com/s/articleView?id=platform.devops_center_dev_environment_sharing.htm&release=264.0.0&type=5 "Changes are associated in Lifecycle Center with the development environment within a project. Therefore, we recommend that all developers have their own development environment. A single development environment can be connected to multiple work items.")