Skip navigation

Clone existing projects

David Klement
3 min read
Download PDF

Cloning a project is useful when you want to reuse what you have already created. You can copy the content model as well as the content itself. If you want to test breaking changes to your project, use environments for safe testing without fear of breaking your live project.

Table of contents

    Clone a project

    Cloning a project will create a new project that is a copy of the source project. You can choose whether to clone the project with its content or without it.

    You need to be a subscription admin for the project you want to clone.

    1. Click your initials in the bottom-left corner and select Projects.
    2. On the card of the project you want to duplicate, click .
    3. Click Clone project.
    4. Type a name for the new project.
    5. Select the subscription the project will fall under.
      • Consider your subscription limitations for the maximum number of roles and languages that can be included in the plan.
    6. Select a data center for your data.
    7. (Optional) If you want to exclude content items and assets, clear Include content items and assets.
    8. Click Clone project.

    Avoid changes during copying

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

    Cloning entire project

    Considerations

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

    • The time to clone your project depends on the size of your project (for example, cloning a project with 1,000 content items can take 15 minutes).
    • Once the project content is cloned, you can work with the project in Kontent.ai while the Delivery API data is being set up.
    • We recommend that you do not use the Delivery API on the cloned project while its content is being prepared because you could get incomplete data.

    What gets copied

    • Always included:
      • Content types
      • Content type snippets
      • Spaces
      • Preview URLs
      • Taxonomy
      • Languages
      • Roles
      • Workflow
      • Users (only subscription admins)
      • Collections
    • Optionally included when you select Include content items and assets:
      • Content items (including localized variants)
      • Assets
      • Contributor assignments (only subscription admins)
      • Due dates
      • Comments (author names and mentions of users who aren't subscription admins will change to Unknown user)
      • Notes
    • Never included:
      • Revisions of content items (only the published and latest versions are cloned)
      • Tasks
      • Environments

    Create projects based on a template

    Another way to clone a project is to use it as a template when you're creating a new project. This may come in handy if you're an agency and create projects for your clients based on one prepared content model, for instance.

    Click your initials in the bottom-left corner and select Projects. Then, click Create new project and select an existing project as a template. The rest is the same as with cloning a project.

    Moving a project under a different subscription

    Subscription admins of both the original and the target subscriptions can move a project between subscriptions using project cloning.

    What's next?