Skip to main content
A sandbox is a WordPress site WPOS provisions for you, with the plugin already installed and connected. Use one to try a build, prototype a layout, or demo the agent without touching a client site or standing up hosting first. Every sandbox is permanent: it stays until you delete it. When the work is ready for real hosting, you can move it there with everything it holds.

Create a sandbox

1

Click New sandbox

On the Workspace dashboard, click New sandbox next to Add Site.
2

Give it a name

The name becomes the sandbox’s address, for example acme-demo.try.wpcursor.com. Use letters, numbers, and hyphens. WPOS checks the name as you type and marks it available or taken; when it is taken, it suggests alternatives under Try instead. Leave the field blank and click Use default name to get a generated name you can change later.
3

Choose your plugins

Optional. Pick plugins to have them installed and activated before the sandbox is handed over. Search the list and select up to the limit shown, then click Launch with N plugins, or Launch sandbox to start with none.
4

Let it launch

Progress shows each stage: Container provisioned, WordPress installed, and Plugins installed. It usually takes one to two minutes. You can close the dialog and keep working; the launch carries on in the background.
When it finishes, Your sandbox is ready offers Open WPOS chat to start building straight away, or Not now.
Creating sandboxes is for the workspace owner by default. Team members see New sandbox with a padlock and can ask for it with Request access. See Members.

Working with a sandbox

The sandbox appears in your connected sites list, marked Permanent. Click Open WPOS chat to work in its Command Center exactly like any connected site: the agent builds, the preview updates, and credits meter the same way. Click the sandbox’s row to open its details:
  • URL, Username, and Password for its wp-admin, each with a copy button. The password stays hidden until you show it.
  • Plugins requested at launch, with the result for each one.
Its menu carries the same actions as any other site, including handoff, so you can hand a finished sandbox to a client the same way. When a team member created the sandbox, the owner sees who made it beside its name. Every sandbox starts on the address it was created with. To change it, open the sandbox’s details and use Sandbox link: type a new name and click Save link. The original link keeps working, so anything you have already shared stays safe. Use the original link switches back.

Use your own domain

You can serve a sandbox on a domain you own. In the sandbox’s details, open Custom domain, enter the domain, and click Attach domain. Then:
  1. At your DNS provider, create an A record for the domain pointing at the address WPOS shows you. Each address has a copy button.
  2. Wait for DNS to update. Changes usually appear within minutes but can take up to an hour. WPOS checks for you in the background, or click Check now.
  3. WPOS issues the certificate itself. The status moves from Waiting for DNS to Issuing certificate to Live.
If something is wrong, the status shows DNS mismatch or Certificate failed. WPOS sends an email explaining what to fix, and another when the domain goes live. The sandbox’s original URL keeps working alongside your domain. To stop using the domain, click Remove domain.

Move a sandbox to real hosting

When a sandbox is ready to become a real site, move it with its Migration key:
  1. Open the sandbox’s menu and choose Migration key, then copy the key.
  2. Install the WPOS plugin on the WordPress site you want to move it to.
  3. In the plugin, choose Migrate a site and paste the key.
The sandbox moves there with its chats, connectors, and settings. Whatever was on the destination install is replaced, so use a fresh site. The migration key is only for moving a site; to connect a new site to your account, use your license key instead (see Install). For the full walkthrough, with a video, see Move a site to a new install.

Delete a sandbox

Open the sandbox’s menu and choose Delete sandbox. Deleting removes the WordPress container and the sandbox’s site, including its chats, connectors, and settings, and cannot be undone. Credits it spent stay in your account history. Deleting is for the workspace owner by default.
Reach for a sandbox when a prospect wants to see WPOS work but you do not want to touch their live site yet. Build the idea on a sandbox, give it a readable link, and share it. If they sign, move it to their hosting with the migration key.