Repository cloning is included with all Enterprise plans and is available as a paid option on yearly Platinum plans. Reach out to our Sales team for more information.
We recommend using a development environment for Prismic repositories if you have a continuous development cycle and are regularly implementing new designs or components to your website.
This option allows you to clone the entirety of your production repository to a development environment: copying all of the custom types, documents, and assets. The user-base remains independent, ensuring that only the relevant developers and content editors have access to the development environment.
Once cloned, you can perform the necessary changes to your custom types, create new ones, and safely test them out in the development environment of your codebase. Your development application can connect to the Prismic development API endpoint.
How can I clone my production repository?
Simply reach out to email@example.com or, if you are on an Enterprise plan, directly to your customer success manager.
Should I use these environments for staging content?
No, these environments are only meant for updating the codebase or custom types without jeopardizing the production repository. We recommend that content editors stay on the production repository to author new content. This is to simplify the authoring experience without having to push content from one environment to another and because migrating content from the staging repository to the production one isn't ideal (see limitations of the Import/Export tool for more about this). If you need to stage content safely, we recommend that you look into Content Releases.
How do I promote my changes from the development environment to the production repository?
To update an existing custom type, simply copy its JSON structure from the "JSON Editor" tab in the development environment and paste it in its equivalent custom type in the production repository.
What happens if I delete/update a field when promoting a custom type from development to production?
You cannot rename the API ID of a field. More details here.
If you want to remove a field, have a look at what happens here.
If you're switching a "Rich text" field type into "Key text", read more about the behavior here.