Environments

Create an environment

Creating an environment means creating a copy of a selected environment, such as Production. You can use the copy for development and testing purposes. You can create as many environments as your subscription plan allows. If you need to perform content model changes, we recommend using a code-first content migration. You can create new environments in Project settings > Environments. By default, the content item version history is omitted when cloning environments for a faster cloning experience. If you choose to include version history, the new environment will contain up to 50 latest versions for each content item.

What happens when you create an environment?

By default, cloning a new environment means creating an exact copy of the source environment, including:

• Content & assets – assets, content items along with their versions, comments and suggestions, and tasks)
• Content model – content types, asset type, content type snippets, and taxonomies
• Environment settings – collections, languages, preview URLs, roles, spaces, webhooks, and workflows
  • Specific Innovation Lab features, such as semantic search and suggest linked items with AI, will be deactivated in the cloned environment.

User access to the new environment depends on their role. When creating an environment, you can choose which users to activate by selecting their roles. Project managers have access to all environments. Webhooks are set as disabled in the new environment to ensure they don't trigger your production apps and services.

Get your environment ID

You use the environment ID to tell Delivery API where to look for content. An environment ID looks like this: 8d20758c-d74c-4f59-ae04-ee928c0816b.

1. In Kontent.ai, select a project and its environment using the two drop-downs at the top left.
2. In Environment settings > General, click  to copy the Environment ID to your clipboard.

Select an environment in the UI

You can switch among the current project’s environments using the second drop-down at the top. You can also change environments in Project settings > Environments by clicking Go to environment.

Environment swap – mark environment as production

With environment swap, you can mark any non-production environment as your new production environment. When selecting environments, the new production environment will show at the top of the list.

Before you swap

Before you attempt to swap your environments, consider the following:

• Start by cloning your production environment for a safe non-production space.  Make desired changes here.
• Implement a content freeze to prevent content changes in production, avoiding loss of produced content during the swapping process.
• After testing in the non-production environment, mark it as production. Then, end the content freeze and resume content creation.

How to swap environments

To mark a non-production environment as production, go to Project settings > Environments, and click Mark as production. If you want to disable your webhooks in the new production environment, unselect Enable webhooks after the swap is done. Otherwise, the webhooks will be enabled.