Exploring Developer Sandboxes

  • Release version: Zurich
  • Updated July 31, 2025
  • 4 minutes to read
  • Developer Sandboxes enable delegated developers and admins to request, access, and manage individual sandbox environments on top of the same underlying development instance.

    Figure 1. How Developer Sandboxes work
    Developer Sandboxes architecture and workflow. For the text description, refer to the following sections.
    • Developer Sandboxes are isolated environments for parallel building and testing.
    • Each sandbox is provisioned on demand and fully isolated from others.
    • Every sandbox contains the full metadata of the base instance.
    • Sandboxes can be assigned to specific stories, developers, test plans, or custom criteria.

    Developer Sandboxes overview

    Developer Sandboxes aim to provide lower-cost developer isolation and parallelism for customer development environments and instances. Developer Sandboxes are workflow-agnostic and are broadly applicable across workflows for both smaller and larger companies.

    Organizations can face challenges when addressing urgent defects and critical feature enhancements simultaneously in applications. Traditional shared development environments introduce risks such as code conflicts, configuration overlaps, and deployment delays, making it difficult to manage parallel workstreams efficiently. Development teams struggle to deliver urgent fixes and new features concurrently without disrupting each others' progress. The absence of isolated, independent development environments slows down delivery, increases rework, and hampers overall agility.

    Developer Sandboxes enables better development in the following ways:
    • Isolation: Each developer works in an independent sandbox, ensuring changes do not affect other team members’ work.
    • Faster delivery: Teams can work concurrently, reducing development cycle time and enabling faster turnaround for urgent fixes and enhancements.
    • Safe testing: Developers can test configurations, workflows, and integrations within their sandbox without risking system stability.
    • On-demand provisioning: Admins and developers can quickly provision sandboxes for specific tasks or experiments without waiting for shared resources.
    Note:
    Personal Development Instances (PDIs) are still available, but they don't have a controlled baseline configuration like Developer Sandboxes do.

    Sandbox Management home dashboard.

    The Sandbox Management home dashboard displays the total, available, and allocated sandboxes in your instance. The dashboard also displays information relevant to each sandbox, including, the status, data utilization, owner, last accessed date, and when the sandbox was allocated.

    Check your entitlements to determine whether you have access to Developer Sandboxes. For more information, see Developer Sandboxes entitlements.

    Note:
    Cloning and upgrading an instance removes all sandboxes from the instance. For details, see Cloning and upgrading considerations for Developer Sandboxes.
    Note:
    Build Agent it not yet supported in Developer Sandboxes.

    Integrate sandboxes with source control

    Developer Sandboxes provide an isolated environment that integrates with source control, such as Git. Using merge tools helps eliminate conflicts and enables parallel development. For more information, see Source control and Developer Sandboxes.

    Developer Sandboxes users

    Table 1. Users
    User Description
    Delegated developers Delegated developers can request, allocate, or retire sandboxes.
    Admins Admins can allocate or retire sandboxes.
    Sandbox users use the same login credentials for their sandbox as the base instance. If you use Single Sign-On (SSO) for login, when you allow it to connect to your account on the base instance, Developer Sandboxes authenticates using the same mechanism and credentials as the base instance. For information on enabling SSO, see Installing Developer Sandboxes.
    Note:
    SSO for sandboxes doesn't work on instances with vanity URLs.

    Developer Sandboxes workflow

    The delegated developer or admin of a sandbox would procure a sandbox, make changes or experiment with development, test their changes, push their changes, and wait for an admin to clone the instance.

    1. A Developer Sandboxes user (either admin or dev) allocates a sandbox to start story work.
    2. The developer makes development changes and tests them out in their fully isolated sandbox.
      Note:
      The work done in one sandbox doesn't appear in other sandboxes or other instances.
    3. Once the developer is content with their work and ready to promote their changes to a shared, integrated environment, they push their changes to the desired upstream shared instance. For example, a test/QA instance. There are two ways to promote changes:
      1. Using source control (preferable) or exports through Git
      2. Using update sets and imports (supported, but not as easy to merge changes)
    4. Further testing can be done on the shared instance.
    5. The admin of a sandbox instance clones changes from the test/QA instance to make those changes the default for all future allocated sandboxes.

    Developer Sandboxes benefits

    Table 2. Developer Sandboxes benefits
    Benefit Feature Users
    Enable parallel development Enable multiple developers the ability to work on different stories or features at the same time using the same starting source code, all while keeping the non-production baseline instance clean.
    • Admins
    • Delegated developers
    Reduce merge conflicts with source control Enables integration with source control for more successful co-development. For more information, see Source control and Developer Sandboxes. Delegated developers
    Reuse sandbox templates Enables delegated developers the ability to reuse data to test their changes without the need to manually input data every time. You can create a template once, and reuse any existing templates when creating sandboxes. For more information, see Using sandbox templates.
    • Admins
    • Delegated developers
    Create Data Generation Profiles Provide the ability to generate synthetic data for testing within the context of developer sandboxes. Developer Sandboxes can't copy all instance data. Data Generation Profiles enable you to generate fake data, but not your sensitive data, for building and testing an application. For more information, see Create a Data Generation Profile.
    • Admins
    • Delegated developers
    Sandbox alias Enables you to easily reference the sandbox you want to allocate.
    • Admins
    • Delegated developers
    Allocate to Enables you to allocate a sandbox to yourself, or for an admin to allocate a sandbox to someone else.
    • Admins
    • Delegated developers