Content Environments and Branching: How It Works in ContentGrid

Your team is launching a redesigned pricing page. It needs a new content type, three new fields on the existing PricingTier type, and content updated across 12 entries. If you make those changes directly in production, your live site breaks while you're mid-migration. Content environments solve this by giving you an isolated copy of your schema and content to work in.

What an Environment Is

An environment in ContentGrid is a full copy of your schema and, optionally, your content. Each environment has its own API keys, its own entry state, and its own publish history. Changes in one environment don't affect another until you explicitly merge or promote them. You get a production environment by default and can create as many additional environments as your plan allows.

Common Environment Patterns

• Staging environment: A permanent secondary environment that mirrors production. Content editors stage changes here before they go live. Developers test API integrations against real content without risk.
• Feature environment: A short-lived environment created for a specific schema change. You add the new fields, update the content, test your Next.js component against it, then merge to production and delete the environment.
• Translation environment: Some teams use a separate environment per locale during the translation process, merging translated content back to the primary environment on completion.

Schema Changes Across Environments

The most valuable use of environments is testing schema migrations safely. In ContentGrid, you can add a field to a content type in a feature environment, update your frontend to consume it, and verify that your Vercel preview deployment works correctly, all before touching production. When you're satisfied, merge the schema change to production. Your editors don't see a broken form mid-afternoon because you pushed a schema update to production during the workday.

Schema changes are the highest-risk content operations you'll make. Environments reduce that risk to near zero by giving you a rehearsal space.

API Keys and Environment Routing

Each environment has its own API key. Your development .env.local file points to a staging or development environment key. Your Vercel production deployment uses the production environment key. Switching a deployment between environments is a one-variable change. This makes it easy to test a complete end-to-end flow (CMS content, API response, frontend render) in isolation before it reaches real users.