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.appaddress 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
- Click Publish in the top bar.
- Open the publishing settings.
- Add the staging domain in Domains.
- Add the DNS records at your domain provider.
- On the domain row, set the environment to Staging.
The primary domain cannot be a staging domain.
Publish to Staging
- Click Publish.
- Select Staging in the environment choice.
- Unselect Live if you want only a test publish.
- Click Publish.
- Wait until the progress list shows On staging.
- 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.