Sandbox Action and Status Reference
Access the list of your sandboxes from the Sandbox Setup page. Each entry shows the status of the sandbox and the actions that you can take.
Required Editions
| Available in: both Salesforce Classic and Lightning Experience |
| Available in: Professional, Enterprise, Performance, Unlimited, and Database.com Editions |
| User Permissions Needed | |
|---|---|
| To view a sandbox: | View Setup and Configuration |
| To create, refresh, activate, and delete a sandbox: | Manage Dev Sandboxes (Developer or Developer Pro only) or Manage Sandboxes (all sandbox types) |
Available Sandbox Actions
You can perform these actions from the sandbox list and on the sandbox detail page. To view the sandbox detail page, click a sandbox name.
| Action | Description |
|---|---|
| Log In | To log in to the sandbox as an admin, click Log In. This option is available only to users logged in as an admin and only for active sandboxes. |
| Refresh | To replace a sandbox with a new copy, click Refresh. This option is available only for sandboxes that can be refreshed. This process replaces the sandbox with a copy of your production org. Requests to refresh a sandbox can’t be canceled. Your existing copy of the sandbox remains available while you wait for the refresh to be completed. After the process is complete, the refreshed copy is inactive until you activate it. |
| Activate | To access a refreshed sandbox, activate it. Click Activate. This option is available only for sandboxes with the Pending Activation status. Activating a refreshed sandbox replaces the current sandbox with the refreshed version and permanently deletes the older version and all data in it. Your production org and its data aren’t affected. |
| Discard | To discard a refreshed sandbox, click Discard. This action is available only for refreshed sandboxes that aren’t activated. When you discard a refreshed sandbox, the sandbox reverts to its previous version, and the new version is deleted. |
| Del | To remove the sandbox entirely, click Del. Deleting a sandbox permanently erases the sandbox and all data in it, including any outbound change sets that have been uploaded from the sandbox. Your production org and its data aren’t affected. |
Sandbox Statuses
| Status | Description |
|---|---|
| Sampling | The copy engine is determining which object records are sampled and copied from the production org. This status is used only by Partial Copy sandboxes. |
| Pending | The sandbox is in the queue to be processed by the copy engine. If other sandbox copy requests were made before yours, your sandbox could remain in this state for an extended time. |
| Processing | The copy engine picked up the copy request and is building the sandbox. |
| Suspended | The copy engine was interrupted while refreshing or creating the sandbox. The copy engine automatically recovers from this state and returns to Processing. If this status remains unchanged for more than one hour, contact Salesforce Customer Support. |
| Stopped | Multiple events prevented the copy engine from completing a process. If your sandbox is in this state, contact Salesforce Customer Support for specific details and next steps. Salesforce is notified automatically about sandboxes in this state so that we can resolve the issues. |
| Pending Activation | The copy engine created the sandbox. You can now activate or discard the sandbox. |
| Activating | The copy engine is completing the final steps to make your new sandbox available. |
| Discarding | The copy engine is discarding the refreshed sandbox, because an admin clicked Discard. The current sandbox and your production org aren’t affected by this process. |
| Completed | The copy engine created or refreshed the sandbox, and an admin activated it. You can log in to your new sandbox. |
| Deleting | The copy engine is deleting the sandbox and its data, because an admin clicked Delete. This process doesn’t affect your production org. |
| Locking | A background process locked the sandbox. For more information, see the Locked status. |
| Locked | You can’t log in to this sandbox because some or all of your sandbox licenses expired. Contact your account manager to restore the expired licenses. After a license expires, you have 60 days to restore it. If the licenses for this sandbox aren’t restored within 60 days, your sandbox is deleted. |

