Nue Sandboxes: Develop, Test and Validate with Confidence

nue sandboxes provide secure, isolated environments where you can confidently develop, test, and validate changes without impacting your production data or workflows whether you’re building new features, troubleshooting issues, or running simulations, sandboxes ensure your work remains safe and controlled this guide walks you through the end to end lifecycle of nue sandbox management including creation, connection, configuration, and best practices so you can streamline your development process and reduce deployment risk let's get started! this feature is currently in preview you can provision sandboxes, connect them to salesforce, activate them, and copy lifecycle manager configurations however, billing and other configuration settings will be automatically copied from the connected production tenant starting in release 2507 what are nue sandboxes? a nue sandbox is an isolated, pre production environment that mirrors your production setup, enabling you to safely implement, configure, and test changes before deploying them live nue sandboxes can be connected to your salesforce sandboxes, they are designed for end to end validation of any products and pricing configuration, billing and collection workflows, or automation across the revenue lifecycle each nue sandbox is connected to a corresponding salesforce sandbox and managed centrally within the nue platform from the nue admin interface, you can provision new sandboxes, establish or update salesforce connections, refresh configurations, and manage their full lifecycle—including provision, activation, deactivation, and replacement nue sandboxes are accessible at https //app sandbox nue io as shown in the sandbox lifecycle diagram, sandbox environments evolve over time—salesforce sandboxes may be refreshed or replaced, requiring updates to their linked nue sandboxes nue provides flexible options to reconnect , replace , or retire sandboxes to ensure your environments remain in sync and ready for rigorous pre production testing when working with multiple sandbox environments, nue offers two main approaches to ensure proper alignment with salesforce sandboxes solution i is suitable when a salesforce sandbox has been refreshed or replaced, but the corresponding nue sandbox remains active in this scenario, you can reconnect the existing nue sandbox to the new salesforce sandbox however, a key consideration with this approach is the need to purge data in the nue sandbox purge data in the nue sandbox before reconnecting this ensures data consistency and prevents potential conflicts between outdated sandbox data and the refreshed salesforce environment in contrast, solution ii involves a full environment reset , where both the salesforce sandbox and the associated nue sandbox are replaced this approach establishes a new connection between the refreshed salesforce sandbox and a newly provisioned nue sandbox, while the original nue sandbox is deactivated solution ii is recommended when you want a clean slate or need to mirror an entirely new salesforce environment for more extensive testing or implementation overview of sandbox management key capabilities seamlessly provision new nue sandboxes , each connected to a corresponding salesforce sandbox org track and manage sandbox licenses , with controls to enforce limits on active environments automate re connection workflows when salesforce sandboxes are refreshed or replaced automatically copy production configurations to sandboxes upon initial connection maintain full visibility and control with a clear ui for managing sandbox status and lifecycle actions access your nue sandboxes via nue sandbox environment licensing and permissions this feature requires a sandbox management license every nue customer is provided with one sandbox license by default at no additional cost if you require additional sandboxes for example, for development, uat, or staging environments, please contact your account manager to purchase additional licenses permissions to access "sandbox management" feature, the following functional permission is required for the user role sandbox management manage sandboxes getting started to get started, admin users should log in to the production tenant and follow the steps below to access sandbox management login to your production tenant navigate to system settings, and search sandbox management on the sandbox management page, users can view all sandboxes associated with their current production tenant and create new sandboxes columns in the sandbox list include action (login, deactivate, connect/re connect, edit, delete) sandbox name sandbox alias, e g ,dev, uat, staging sandbox admin name status available values are created, pending connection, salesforce connected, pending activation, active, inactive status messages created date activated date sandbox lifecycle and actions each nue sandboxes moves through a set of statuses, with available actions tailored to each step the status transition can be illustrated below created → pending connection → salesforce connected → pending activation → active → inactive created → pending connection → salesforce connected → pending activation → active → inactive the following table outlines the actions available by status status description available actions created sandbox has been created but not yet accessed first login and salesforce connection are pending connect to salesforce edit delete pending connection the sandbox tenant is logged in for the first time, but not yet connected to salesforce activation requires connection connect to salesforce edit delete salesforce connected connected to salesforce configuration is being copied from production no action required refresh configuration activate login reconnect to salesforce edit delete pending activation connected to salesforce, configuration copied from production, and ready for activation refresh configuration activate login reconnect to salesforce edit delete active this sandbox is active and ready to use refresh configuration login reconnect to salesforce edit deactivatedelete inactive this sandbox is deactivated and can be safely deleted delete edit license usage salesforce connected sandboxes with statuses salesforce connected , pending activation , or active all count toward your sandbox license usage key actions explained connect/reconnect to salesforce authenticate and link the sandbox to salesforce available in most statuses except inactive refresh configuration copies latest configuration settings from the connected production tenant activate enables sandbox for use only for pending statuses deactivate sets the sandbox to ‘inactive’ users can no longer log in edit change sandbox properties at anytime delete delete sandboxes that are not active users can no longer log in provisioning a new sandbox provisioning a new sandbox from salesforce to connect a nue sandbox to a salesforce environment, you need to first provision a new salesforce sandbox from your salesforce production org salesforce sandboxes are isolated environments where you can safely develop, test, and stage changes before deploying them to production once created, these sandboxes can then be linked to nue for end to end sandbox lifecycle management prerequisites you must have system administrator access to the salesforce production org your org must have available salesforce sandbox licenses step by step how to create a new salesforce sandbox 1\ log in to your salesforce production org navigate to https //login salesforce com or your custom salesforce domain use credentials for the production environment (not a sandbox) 2\ go to sandbox setup in the upper right corner, click the gear icon , then select setup in the quick find box on the left, search for “sandboxes” and click on it 3\ click “new sandbox” you’ll see a list of existing sandboxes (if any) click the “new sandbox” button to begin provisioning a new environment 4\ enter sandbox details sandbox name this will be the subdomain for login (e g , mydevsandbox → mydevsandbox mydomain sandbox my salesforce com) description optionally add a note about its purpose (e g , “uat testing” or “nue dev integration”) sandbox type choose from developer lightweight, includes metadata only developer pro more storage partial copy includes metadata + sample data (requires template) full copy complete replica of production (includes data; longer creation time) 5\ (optional) select a sandbox template for partial copy and full copy sandboxes, select a template to control which data is included 6\ click “create” salesforce will begin provisioning the sandbox this process may take a few minutes to several hours depending on the type and size of your org 7\ monitor progress return to the sandboxes page in setup to view the status once it reaches “active” , you can log in using the sandbox url https //\<sandboxname> sandbox my salesforce com salesforrce doc references salesforce help create a sandbox provides step‑by‑step guidance directly from salesforce setup to creating a sandbox salesforce trailhead set up a sandbox in your salesforce org a learning module that covers sandbox types, use cases and setup instructions salesforce help sandboxes—staging environments for customizing and testing offers an overview of sandbox usage, including its benefits for development and testing provisioning a nue sandbox now that your salesforce sandbox is ready, you can provision a corresponding nue sandbox and connect it to the newly created salesforce environment to get started navigate to system settings → sandbox management click “new sandbox” fill in the required fields organization name / connected production tenant – (read only) sandbox name – (required) alias – (required, must be unique, max 30 characters; letters, numbers, and hyphens only) admin emails – (required) you may use the same admin email as your production tenant—there’s no need to use a different email for each sandbox linked to the same production tenant all other configuration values will be automatically copied from the production tenant, including the number of user licenses note that the sandbox management licenses will not be copied from the production tenant finally, click “provision” to create the nue sandbox the sandbox will be created in a few seconds, currently, only ‘configuration only’ sandboxes are supported full copy sandboxes are coming soon upon provisioning sandbox appears in ‘created’ status when the admin logs in for the first time, status becomes ‘pending connection’ once connected to salesforce, configuration is copied and status moves to ‘pending activation’ after activation, sandbox is ready for use the sandbox will be provisioned in the nue sandbox environment within a few seconds connect to salesforce sandbox after the sandbox is created, the sandbox list is refreshed with the newly provisioned sandbox record users can click on the "cloud" icon to redirect to the sandbox login page in a new browser tab or window to login to the sandbox environment for the first time, and connect to the salesforce sandbox if you provide a unique admin email that hasn’t been used in the sandbox environment before, an activation email will be sent, prompting the admin to activate the new sandbox tenant if you use an existing admin email already associated with another nue sandbox, no activation email is needed—you can simply log in with that email and select the newly provisioned sandbox from the environment switcher, as shown in the image below after logging in to the newly provisioned sandbox successfully, you can follow nue on salesforce setup and configuration guide to connect the nue sandbox with a salesforce sandbox please make sure to select 'sandbox' as the salesforce environment when initiating the connection with the salesforce sandbox, as shown in the following image once the salesforce connection is successfully established, users will see a confirmation screen indicating that the connection is active at this point, the admin user in nue is linked to the corresponding admin user in the salesforce sandbox , and the nue api user is also mapped to the same salesforce admin , allowing the api key to operate with the appropriate admin level permissions the admin can now begin adding users in nue and mapping them to users in the salesforce sandbox automatic user provisioning & mapping the user mapping process will be automated in an upcoming release reconnect to salesforce sandbox within a nue sandbox tenant, you can reconnect to your salesforce sandbox at any time if the salesforce connection or reconnection fails the sandbox status will revert to the previous state (e g , pending connection or pending activation ) an error message will appear, explaining the reason for the failure you can retry the connection whenever you’re ready refresh configurations from production once the salesforce connection is successfully established, return to the production tenant , go to settings → sandbox management , and click the refresh icon above the sandbox list you’ll now see the newly provisioned sandbox with the status “salesforce connected” , as shown below it’s important to note that many lifecycle manager and billing settings are stored in salesforce custom settings , which are already copied over when the salesforce sandbox is created from production as a result, most of these configurations are already available in the nue sandbox once the connection is established to finalize setup, simply navigate to settings → business object , and click “sync custom fields from salesforce” this step ensures that lifecycle manager and billing configurations are fully synchronized in your newly connected nue sandbox coming soon a complete configuration copy and refresh including all remaining settings will be supported in release 2507 the following will also be available in release 2507 once the salesforce connection is successfully established, nue will automatically begin copying configuration settings from the production tenant into the nue sandbox this includes settings related to lifecycle manager , billing , webhooks , security , and more after this process is complete, the sandbox status will automatically update to “pending activation ” at any time, users can click “refresh configurations” to pull the latest settings from the production tenant this functionality will be available starting in release 2507 now, click the “refresh configuration” action icon to update the sandbox and set its status to “pending activation ” if you’re ready to proceed, you can click the “activate” action icon to immediately activate the sandbox troubleshooting you can view sandbox status messages by clicking on the 'view' action icon the sandbox status messages panel provides a detailed timeline of key events during the sandbox lifecycle, including creation, salesforce connection attempts, and configuration copy status as shown in the example, it logs both successful steps—like sandbox creation and connection to salesforce—and failures, such as configuration copy errors or connection issues these messages help admins troubleshoot issues quickly and understand exactly where the provisioning or setup process may have failed nue sandbox faq what happens if license limits are reached? you’ll see a license limit error—deactivate or delete other sandboxes, or contact your account manager can i copy configuration from production more than once? yes, use refresh configuration —except for sandboxes that are inactive or not yet connected this feature will be available in release 2507 is a full data copy supported? currently, only configuration only sandboxes are available full copy support is planned for the future