CommunityDevOps ExchangePartners
10 minutes

How to Keep Salesforce Sandboxes in Sync

Written by
Cassia Wallach
Table of contents

Keeping your Salesforce Sandboxes in sync is crucial to the success of your organization. However, it is a critical area often overlooked until DevOps teams experience out of sync environments — resulting in merge conflicts, overwrites, erroneous deployments and other business challenges.

Managing environments is the cornerstone of an efficient DevOps process, yet not many DevOps teams prioritize it in their day-to-day workflows. This article covers the fundamentals and best practices of developing an environment strategy and provides recommendations on leveraging your people, processes and tools to maintain your environments.

Common Obstacles to Environment Synchronization

According to a survey by Copado, nearly 60% of Salesforce professionals experience issues caused by out of sync sandboxes. That begs the question: if the majority of us know the consequences of sandbox misalignment, why do we still struggle with this critical aspect of DevOps?

Keeping sandboxes in sync requires a holistic approach, optimizing all aspects of the software development lifecycle, starting with the people, then the process and, finally, the tools. If these three pieces of the puzzle are not aligned, it will create challenges that can ultimately lead to an environment maintenance nightmare.

The root of these challenges lies in the issue of conflicting metadata changes made by different team members across multiple sandboxes and then keeping track of these changes. When there are disparate versions of the same component in different environments, merge conflicts occur in higher environments. At the same time, developers work on features that are out of sync with the version that’s in production. This can lead to changes being made directly in higher-level environments rather than at the developer sandbox level, which causes further inconsistencies and costly delays.

Defining a Best Practice Environment Strategy

To avoid these challenges, it’s important to create a process surrounding environment management. Environment management encompasses all activities surrounding the planning and maintaining an organization's Salesforce environments.

Once you have an environment management strategy in place, you should define a scalable approach that enables your team to deliver value while combating the factors that cause environments to fall out of sync. Defining an environment strategy is crucial to the long-term success of your delivery organization and should not be taken lightly. At a high level, it can be broken down into three distinct categories:

  1. Stage Definition and Environment Relationships
  2. Deployment Process Definition and Automation
  3. Maintenance and Monitoring

Let’s look at what goes into each category and then walk through some industry standard best practices for a robust and efficient DevOps process.

Stage Definition and Environment Relationships

To implement environment management, it is crucial to understand the needs of your organization and the Salesforce delivery team. Ask yourself:

  • What are the goals of your Salesforce delivery team?
  • Are there any requirements surrounding your Salesforce environments for each stage in the Development lifecycle?

Once you have conclusive answers to these questions, you have the information needed to define your environment types and quantity and you can categorize them based on their intended purpose. Follow a standardized naming convention to label your environments before establishing the topology: relationships and dependencies between Salesforce environments and any external tools or data sources.

Deployment Process Definition and Automation

At this point, you likely have determined the structure of your pipeline. You know how many environments are there in your pipeline, how they are connected and what you need to define the behavior that occurs as changes are created, tested, and then migrated from one environment to the next.

The planning phase defines and enforces a transparent deployment process that includes crucial elements such as version control, quality gate enforcement, and automation. By systematically enforcing and automating these practices, you establish a robust and reliable deployment process that promotes consistency and efficiency in your Salesforce environments.

Maintenance and Monitoring

Now that you have determined your pipeline structure and its behavior, it’s time for you to implement best practices surrounding security, documentation, ongoing monitoring, and maintenance. For your environment strategy to be upheld, it needs to be documented and communicated to the broader team, along with any environment maintenance policies that have been outlined. Finally, establish an environment strategy review cadence to adapt your process to the evolving needs of your industry and company.

Environment Strategy Best Practices

While every Salesforce org is different and calls for unique requirements and processes, there are industry standard best practices that revolve around environment strategies. The following best practices serve as guidelines to help organizations optimize their Salesforce implementations and ensure consistency, scalability and maintainability:

Stage Definition and Environment Relationships

(1) Implement Agile Planning: Agile planning can vastly benefit your Salesforce Sandbox development process. The methodology entails a rapid and iterative approach to development, prioritizing high quality at every stage. You can anticipate and resolve issues early by breaking down tasks into smaller, more manageable chunks and putting a premium on quality from the outset.

This makes for a more efficient development process, with fewer hiccups in higher-level environments. Moreover, the agile approach emphasizes customer satisfaction by creating a continuous feedback loop so that changes can be made as early on in the process as possible. This ensures that the final product meets and exceeds the needs and expectations of your customers.

(2) Enforce Clear Deployment Path: Having a clear deployment path ensures that delivery teams are all on the same page and should be customized to fit the needs of your business. A best practice promotion path begins in a developer sandbox, at least one integrated testing environment, UAT or Staging, Production and then a hotfix environment to manage potential production bugs impacting end users.

(3) Develop Strictly in Developer Environments: It is crucial to ensure that developers only make changes in developer environments to avoid out of sync issues and delays in the deployment process. By working in their own sandboxes, developers can promote parallel and isolated development, allowing for greater control over the development process.

This also enables developers to work on features and changes in a controlled environment before pushing them to higher-level sandboxes for testing and deployment. Additionally, working in their own sandbox allows developers to avoid merge conflicts caused by conflicting metadata changes, ensuring that code changes remain isolated and organized. Implementing these practices can lead to faster development and deployment times, promoting greater overall efficiency and quality.

Deployment Process Definition, Enforcement, and Automation

(1) Decide on Consistent Tooling: Multiple tooling options exist to manage Salesforce deployments. These include out-of-box functionality called “Change Sets,” CLI, the metadata API and third-party tools ranging from lightweight to heavyweight all-in-one deployment tools backed by version control.

The tooling choice will depend on an organization's specific needs and will impact the capability of a delivery team to follow DevOps best practices. Regardless, once a tool is selected, it should be used consistently across the entire team, who might need to be trained on how to use it effectively.

(2) Implement Version Control: Version control is critical for businesses of all sizes. Tracking and managing code changes helps your developers identify and eradicate errors easily and allow them to work collaboratively, efficiently and safely. Some common Git-based version control repository platforms include Github, Gitlab, Bitbucket and Azure Repos — any of which can be used effectively in storing Salesforce metadata code history. If made possible by tooling, it is also a good practice to enforce a standardized branching strategy and automate branching activities to save time, reduce the risks of human errors and enable admins or developers to use version control regardless of their level of Git knowledge.

(3) Enforce Quality with a “Shift-Left” Mindset: The principle of Shift Left emphasizes the importance of early and frequent testing to catch any potential issues as soon as possible. This means testing features and functionality as soon as they are developed rather than waiting until the end of the development cycle.

Embracing the shift left mentality and enforcing quality gates lets organizations identify and address issues early in development, preventing inconsistencies and discrepancies between sandboxes. These practices facilitate early detection of problems, minimize regression issues, and ensure that only high-quality and tested code progresses through the development pipeline, keeping sandboxes in sync and promoting overall application stability.

Quality gates should be required and run in each environment to ensure that all changes are being tested and approved at every stage of the deployment process. These quality gates could include validation deployments, unit tests (Apex Tests, SCA), and functional testing and approvals. Once a test strategy has been designed, it is crucial to make sure that they are enforced. Developers should only be able to deploy changes to a higher environment once they have ensured that their updates comply with an organization's quality standards.

(4) Enable Continuous Integration and Deployment (CI/CD): Integrating your sandbox strategy with CI/CD best practices is crucial for automating build, testing and deployment processes. By implementing Continuous Integration (CI), changes committed to the version control system trigger automatic builds and tests. This ensures frequent validation and merging of code changes, minimizing conflicts and discrepancies between sandboxes.

By leveraging version control, automated build processes and comprehensive testing, you establish a streamlined CI pipeline that guarantees code consistency and quality. Furthermore, extending automation to include Continuous Deployment (CD) allows you to automate the release process and, moving changes seamlessly from the sandbox to production. This approach reduces manual errors, improves collaboration and enables faster, more reliable deployments.

Maintenance and Monitoring

(1) Define and Enforce Roles, Authorization, and Access: When implementing a successful Salesforce CICD strategy, it is essential to establish clear roles and responsibilities within the DevOps team. Each team member should only be given enough access to perform their specific job functions without compromising the security of the organization's Salesforce environment.

Regarding access control, the principle of least privilege should be applied. This means that each team member should only have access to the resources and information they need to do their job effectively. For example, developers should only have write access in their personal developer environments. This will enforce that all changes start at the development level and are applied to every environment in the pipeline before reaching production.

(2) Create a rollback strategy and (if possible) automated back promotions: A rollback strategy is a backup plan that enables the rapid reversal of changes made to sandboxes should an error occur while promoting new features. Automated back promotions allow developers to roll back changes from production to sandbox environments automatically.

This automated process ensures that the sandbox remains in sync with the production environment and reduces the risk of discrepancies between the two environments. Implementing a rollback strategy and automated back-promotion processes will minimize downtime in the event of production errors and make it easier to revert changes, reducing the number of headaches and potential errors that could arise due to user errors.

(3) Plan for Sandbox Refresh and Data Management: Planning a sandbox refresh schedule ahead of time is especially important if back promotions aren’t available with your selected tooling, as lower-level environments will not be maintained with updates made across other dev environments.

Before a refresh, it is a good practice to leverage version control by taking a snapshot of environments so that all work is saved in case there are in-flight changes that were never committed. Scheduling sandbox refreshes and effectively communicating these plans to the rest of the team ensures that any in-flight changes are migrated or backed up before a refresh.

It’s also critical to ensure that you have the correct data and calculate data loading time in advance, as data migrations can take several days. If working with sensitive data, establish policies and procedures for masking and anonymization in non-production sandboxes. Ensure that sensitive customer data is adequately protected to comply with data privacy regulations and to prevent data breaches.

(4) Monitor Org Health with Automated Regression Testing: Effective monitoring practices help DevOps teams proactively maintain the overall health of their Salesforce implementations. DevOps teams can leverage automated testing frameworks and tools to ensure new changes don't inadvertently break existing functionality or affect system performance. This testing approach involves creating a suite of automated test cases that can be executed regularly to verify that system functionality remains intact as changes are made.

(5) Document, Communicate, Track, and Evolve: Document your sandbox strategy, including sandbox types, refresh schedules, data management policies, access control and integration with CI/CD processes. Ensure you communicate this strategy to all relevant stakeholders, including developers, testers, administrators and release managers to ensure a shared understanding and adherence to the defined processes. Finally, set up a regular review cadence to collect feedback and continuously refine your strategy.


Maintaining a robust and efficient environment strategy in today's fast-paced digital era is crucial for businesses striving to outpace their competition. To achieve a successful environment strategy, it is essential to foster a collaborative and transparent culture while assembling a team that values quality, communication, and adherence to best practices.

Businesses can minimize the risks associated with out of sync sandboxes by implementing a well-defined development pipeline, enforcing stringent quality standards and employing robust change management and automation tools and processes tailored to the organization's needs.

It is essential to recognize that environment management is an ongoing endeavor that requires continuous monitoring. Regular reviews and refinements of the environment strategy ensure that businesses remain adaptable to the evolving needs of the Salesforce platform and industry trends. In conclusion, it is crucial to prioritize the development of a robust and future-proof environment management strategy, enabling streamlined development processes, mitigating risks and optimizing Salesforce implementation to drive the growth and success of your business.

See Copado Best Practices In Action

About The Author

With a background in Salesforce Delivery Consulting at IBM, Cassia has had a lot of experience with the value that a good DevOps process and strategy can bring to a team and the pain that process inefficiencies and decentralized tooling can cause. Since joining Copado as a Sales Engineer almost two years ago, the author has worked closely with numerous prospects - many of whom had encountered challenges from out-of-sync Sandboxes. Drawing on her Salesforce knowledge and hands-on experience with Sandbox management, the author provides readers with practical tips and advice on revamping, streamlining, and maintaining synchronicity throughout their pipeline(s).

Book a demo

About The Author

Product Marketing Manager, CICD

With a background in Salesforce Delivery Consulting at IBM, Cassia has had a lot of experience with the value that a good DevOps process and strategy can bring to a team and the pain that process inefficiencies and decentralized tooling can cause. Since joining Copado as a Sales Engineer almost two years ago, the author has worked closely with numerous prospects - many of whom had encountered challenges from out-of-sync Sandboxes. Drawing on her Salesforce knowledge and hands-on experience with Sandbox management, the author provides readers with practical tips and advice on revamping, streamlining, and maintaining synchronicity throughout their pipeline(s).

Copado Launches Copado Explorer to Simplify and Streamline Testing on Salesforce
Exploring Top Cloud Automation Testing Tools
Master Salesforce DevOps with Copado Robotic Testing
Exploratory Testing vs. Automated Testing: Finding the Right Balance
A Guide to Salesforce Source Control
A Guide to DevOps Branching Strategies
Family Time vs. Mobile App Release Days: Can Test Automation Help Us Have Both?
How to Resolve Salesforce Merge Conflicts: A Guide
Copado Expands Beta Access to CopadoGPT for All Customers, Revolutionizing SaaS DevOps with AI
Is Mobile Test Automation Unnecessarily Hard? A Guide to Simplify Mobile Test Automation
From Silos to Streamlined Development: Tarun’s Tale of DevOps Success
Simplified Scaling: 10 Ways to Grow Your Salesforce Development Practice
What is Salesforce Incident Management?
What Is Automated Salesforce Testing? Choosing the Right Automation Tool for Salesforce
Copado Appoints Seasoned Sales Executive Bob Grewal to Chief Revenue Officer
Business Benefits of DevOps: A Guide
Copado Brings Generative AI to Its DevOps Platform to Improve Software Development for Enterprise SaaS
Celebrating 10 Years of Copado: A Decade of DevOps Evolution and Growth
Copado Celebrates 10 Years of DevOps for Enterprise SaaS Solutions
5 Reasons Why Copado = Less Divorces for Developers
What is DevOps? Build a Successful DevOps Ecosystem with Copado’s Best Practices
Scaling App Development While Meeting Security Standards
5 Data Deploy Features You Don’t Want to Miss
Top 5 Reasons I Choose Copado for Salesforce Development
How to Elevate Customer Experiences with Automated Testing
Getting Started With Value Stream Maps
Copado and nCino Partner to Provide Proven DevOps Tools for Financial Institutions
Unlocking Success with Copado: Mission-Critical Tools for Developers
How Automated Testing Enables DevOps Efficiency
How to Keep Salesforce Sandboxes in Sync
How to Switch from Manual to Automated Testing with Robotic Testing
Best Practices to Prevent Merge Conflicts with Copado 1 Platform
Software Bugs: The Three Causes of Programming Errors
How Does Copado Solve Release Readiness Roadblocks?
Why I Choose Copado Robotic Testing for my Test Automation
How to schedule a Function and Job Template in DevOps: A Step-by-Step Guide
Delivering Quality nCino Experiences with Automated Deployments and Testing
Best Practices Matter for Accelerated Salesforce Release Management
Maximize Your Code Quality, Security and performance with Copado Salesforce Code Analyzer
Upgrade Your Test Automation Game: The Benefits of Switching from Selenium to a More Advanced Platform
Three Takeaways From Copa Community Day
Cloud Native Applications: 5 Characteristics to Look for in the Right Tools
Using Salesforce nCino Architecture for Best Testing Results
How To Develop A Salesforce Testing Strategy For Your Enterprise
What Is Multi Cloud: Key Use Cases and Benefits for Enterprise Settings
5 Steps to Building a Salesforce Center of Excellence for Government Agencies
Salesforce UI testing: Benefits to Staying on Top of Updates
Benefits of UI Test Automation and Why You Should Care
Types of Salesforce Testing and When To Use Them
Copado + DataColada: Enabling CI/CD for Developers Across APAC
What is Salesforce API Testing and It Why Should Be Automated
Machine Learning Models: Adapting Data Patterns With Copado For AI Test Automation
Automated Testing Benefits: The Case For As Little Manual Testing As Possible
Beyond Selenium: Low Code Testing To Maximize Speed and Quality
UI Testing Best Practices: From Implementation to Automation
How Agile Test Automation Helps You Develop Better and Faster
Salesforce Test Cases: Knowing When to Test
DevOps Quality Assurance: Major Pitfalls and Challenges
11 Characteristics of Advanced Persistent Threats (APTs) That Set Them Apart
7 Key Compliance Regulations Relating to Data Storage
7 Ways Digital Transformation Consulting Revolutionizes Your Business
6 Top Cloud Security Trends
API Management Best Practices
Applying a Zero Trust Infrastructure in Kubernetes
Building a Data Pipeline Architecture Based on Best Practices Brings the Biggest Rewards
CI/CD Methodology vs. CI/CD Mentality: How to Meet Your Workflow Goals
DevOps to DevSecOps: How to Build Security into the Development Lifecycle
DevSecOps vs Agile: It’s Not Either/Or
How to Create a Digital Transformation Roadmap to Success
Infrastructure As Code: Overcome the Barriers to Effective Network Automation
Leveraging Compliance Automation Tools to Mitigate Risk
Moving Forward with These CI/CD Best Practices
Top 3 Data Compliance Challenges of Tomorrow and the Solutions You Need Today
Top 6 Cloud Security Management Policies and Procedures to Protect Your Business
What are the Benefits of Principle of Least Privilege (POLP) for My Organization?
You Can’t Measure What You Can’t See: Getting to know the 4 Metrics of Software Delivery Performance
How the Public Sector Can Continue to Accelerate Modernization
Building an Automated Test Framework to Streamline Deployments
How To Implement a Compliance Testing Methodology To Exceed Your Objectives