Developers · Setup
How Insites releases platform updates
Last updated 18 November 2026
How platform updates reach staging sites first as a preview, then production sites, and what _rc fields are.
Every Insites site runs on the Insites platform. When we improve the platform, the release goes to staging sites first, as a preview. Production sites get the release within a few weeks. This page explains the steps and why we work this way.
The three steps
- BuildDeveloped and verified by Insites engineers
- Preview on staging sitesReady to use. Your live site is not touched
- Production sitesWithin a few weeks
1. Build
Every release is developed and verified by the Insites engineering team before it is released.
2. Preview on staging sites
The release goes to staging sites first. It is ready to use, so you can try every new feature on your staging site. Your live site is not touched.
3. Production sites
Production sites get the release within a few weeks. When they do, we update the release notes on What's New to say so.
Why staging goes first
- You see what is coming before it reaches your live site.
- You get time to try a new feature, and to get your own site ready for it, before it reaches your customers.
- Your live site changes only after the release has already been running on staging sites.
To learn how the two kinds of site differ, read Staging vs. Production.
How to tell where a release is
Every Platform release on What's New shows a badge: On staging sites or On production sites. When a release moves to production sites, its badge changes.
Release candidates (_rc)
Some new GraphQL fields first arrive with a name that ends in _rc. This is short for release candidate. You can use an _rc field straight away. It is a preview of the field, before its name is final.
When the design is final, the field gets a stable name without _rc. For example, documents_rc became documents. The _rc name keeps working but is marked as deprecated. Use the stable name in new code, and move older code across when you can. What's New says when a field gets its stable name.
Tip
In new code, use the name without _rc once it exists.
What you need to do
You do not install platform updates. They reach your sites for you.
- Read What's New to see what changed.
- Try new features on your staging site first.
- If something on your staging site behaves differently after a release, tell us through Support.