Velaro Site: Going Live, Staging to Production
Everything you publish in Velaro Site lands on v20.velaro.com (staging) first — never directly on the public velaro.com (production) domain. Moving a change from staging to production is always a separate, deliberate action, taken from the Promote tab.
Running the checklist
- Open the Promote tab.
- Choose which pages you're promoting — all of them, or a specific set.
- Enter your name and a short reason for the promotion (both are required — Velaro Site won't let a promotion go out without a named approver and a stated reason).
- Click Run Checklist.
Screenshot callout: the Promote tab with the checklist results listed, each item showing a pass/fail state, and the "Promote to Production" button still greyed out above them.
The checklist runs five automated checks, and every single one has to pass before the Promote button unlocks:
| Check | What it's confirming |
|---|---|
| Required fields | You've entered your name and a reason for the promotion. |
| SEO audit | Staging's pages pass Velaro's SEO rules (titles, meta descriptions, canonicals, sitemap entries, etc.) — the same audit that would otherwise block a deploy. |
| Redirect integrity | The site's redirect rules are internally consistent (no conflicting or duplicate targets). |
| In sync with what's live | What you're about to promote is actually what staging is currently serving — not a stale or half-deployed version. |
| Page-by-page diff preview | Shows you exactly what will change on every page you're promoting, compared to what's live on production right now. |
Reviewing the diff
Before you commit to anything, look over the page-by-page diff. This is your last chance to catch a change you didn't mean to ship, or a page that's about to change more than you expected.
Promoting
Once every check passes, the Promote to Production button becomes clickable. Clicking it triggers Velaro's production deployment pipeline, which re-verifies the same checklist on its own before actually publishing anything — so nothing reaches production on the strength of the checklist result alone.
A promotion attempt — whether it went through or was blocked — is always recorded, so there's a durable history of who promoted what, when, and why.
If Promote to Production won't go through
If you've run the checklist, everything shows green, and the Promote button still won't complete the deployment, the most likely cause is that the production deployment trigger itself hasn't been fully wired up in this environment yet (a required access credential that lets Velaro Site talk to the deployment system may not be configured). This isn't something you can fix from the Promote tab — let an admin know so they can confirm the deployment credential is set up, and try again once they confirm it.
FAQ
- Can I promote just one page instead of the whole site?
- Yes — the page picker at the top of the Promote tab lets you scope the checklist and the deployment to a specific set of pages instead of everything.
- What if the SEO audit fails?
- Go back to the page's SEO sub-tab in the Pages tab, fix whatever's flagged red, publish the fix to staging, and re-run the checklist.
- Is there a way to preview production before I commit?
- The diff preview in step 5 of the checklist is exactly that — a side-by-side of what production will look like versus what it looks like today, for every page you're promoting.
Was this article helpful?