Set up a staging domain

A staging domain shows a test version of your site before changes go to your live domain. For example, use staging.your-company.com for tests and www.your-company.com for visitors.

How staging works

  • Your site has Live and Staging environments.
  • Each custom domain belongs to one environment.
  • Publishing to Staging does not change your live domains.
  • The vercel.app address always shows Live. Only a custom domain can show Staging.

What you need

Staging works after your site has a primary domain and has been published to Live once. You need a custom domain for staging; a subdomain of your main domain is a good choice.

See Link a custom domain and Publish your site first.

Assign a domain to Staging

  1. Click Publish in the top bar.
  2. Open the publishing settings.
  3. Add the staging domain in Domains.
  4. Add the DNS records at your domain provider.
  5. On the domain row, set the environment to Staging.

The primary domain cannot be a staging domain.

Publish to Staging

  1. Click Publish.
  2. Select Staging in the environment choice.
  3. Unselect Live if you want only a test publish.
  4. Click Publish.
  5. Wait until the progress list shows On staging.
  6. Open the staging domain and examine the site.

You can select both environments. Splitleaf publishes to Staging first and Live afterward.

Move a change from Staging to Live

Examine the staging site, then open the Publish window, select Live, and click Publish.