Cloning existing projects

When creating a new project or testing changes to an existing project, reusing what you have already created can save you time and worry.

Table of contents

    Being able to test out changes to your project without the fear of breaking your project will relieve a lot of stress. Cloning your project creates a new project that is a copy of the project. You can then test any changes you would like while leaving the original project untouched.

    Premium feature

    This feature requires a Business plan or higher

    Cloning an entire project

    Cloning a project will create a new project that is a complete copy of the source project.

    To clone an entire project:

    1. In the project switcher, choose My projects.
    2. On the project card of the project you want to duplicate, click More actions .
    3. Click Clone project.
    4. Enter a name for the new project.
    5. Select the subscription the project will fall under.
    6. Select a data center for your data.
    7. Click Clone project.

    Note: Selecting a data center is only possible in the Professional plan or higher.

    Making changes to the source project

    Making changes to the source project while it is being copied could negatively impact the clone. Please wait to make changes until the new project is completely cloned.

    There are a few things to keep in mind when cloning a project:

    • The time to clone your project depends on the size of your project.
    • Once the project content is cloned, you can work with the project in Kentico Kontent while the Delivery API data is being set up.
    • We recommend that you do not use the Delivery API while the project content is being prepared because you could get incomplete data.

    Preparing a project template

    You may find yourself in a situation when you need to reuse existing content models, workflow and roles, and maybe even some of your content in a different project. If you happen to have a multilingual project, you may want the languages to be copied as well.

    Rather than creating a whole new project from square one, you can use an existing project, in which you're the subscription admin, as a template. By default, only the basic structures together with the workflow steps and roles will be cloned to the new project. You can also choose to include up to 100 content items, 100 assets, and languages from the project template.

    Tip: Create a separate project to be used as a project template.

    This way, you don't need to worry about changing something by accident which can happen when reusing a project that's being worked on regularly.

    Creating a project from a template

    When creating a project from a template, the approach is very similar to when creating a new project from scratch.

    1. In the project switcher, choose My projects.
    2. Click Create new.
    3. Type a name for the project.
    4. Select the subscription the project will fall under.
    5. Select a data center for your data.
    6. Select an existing project to be used as a template.
    7. (Optional) Select the checkbox to include up to 100 content items, 100 assets, and languages.
    8. Click Create project.

    Note: In the project templates listing, you will see active projects in which you are the subscription admin and these projects need to be under the Business plan or higher.

    There are a few thing to keep in mind when creating a project from a template:

    • Consider your subscription limitations for the maximum number of custom roles and languages that can be included in the plan (chosen in step 4).
    • When copying the content, your project template cannot contain more than 100 content items and 100 assets. If you exceed this limit, you won't be allowed to clone the project unless you delete the excessive content or clone the entire project.

    What will be cloned in the template

    The following will be cloned from the selected project:

    • Content types / Content snippets
    • Taxonomy
    • Workflow steps
    • Roles
    • (Optional) Languages
    • (Optional) Max. 100 content items
    • (Optional) Max. 100 assets

    Note that to clone the content as well, you need to select the checkbox. Without doing so, the content and languages will not be part of the newly created project.

    What's next?