A project is the primary organizational unit of your content. Create multiple projects to structure your content operations better when working with multiple clients.
Create projects
There are a few things to keep in mind when creating a new project:
Selecting a data center is only possible with paid plans. If you’re on the free trial plan, this option is disabled for you, and your data will be automatically stored in the default data center, which is located in the East US.
Need to change a project name? If you’re a subscription admin, you can rename the project anytime by going to Project settings > General > Project name.The changes are saved automatically.
Archive projects
Only subscription admins can archive projects. When you archive a project, its content cannot be accessed anymore, and all APIs for that project are disabled.Here’s a list of the most important things that are disabled after archiving:
Delivery API – This may break live applications that retrieve content from the project.
Active users – All project contributors will be deactivated and lose access to the project content. They won’t count as active users unless they are active in other projects.
To archive a project:
In Kontent.ai, click your initials in the bottom left corner.
Select Projects.
For the project you want to archive, click .
Select Archive.
Restore projects
In Projects, select the Archived tab.
For the project you want to restore, click Restore project.
After restoring, make sure you activate contributors who were invited to the project so they can start working on the content again.
Clone projects
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.For the project you want to clone, you need to be a subscription admin.
Click your initials in the bottom-left corner and select Projects.
On the card of the project you want to duplicate, click.
Click Clone project.
Type a name for the new project.
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.
(Optional) If you want to exclude content items and assets, clear the Include content items and assets checkbox.
Click Clone project.
Considerations
There are a few things to keep in mind when creating a project copy:
The time to clone your project mainly depends on the number of content item variants and their version history. For example, 40,000 item variants might take about an hour.
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 not using the Delivery API on the cloned project while its content is being prepared because you might 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:
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
Delete projects
You can delete a project if you don’t need one anymore. It’s useful to clean up the growing list of archived projects if you’re, for example, cloning your projects for continuous integration purposes or experimenting with different content models.When you delete a project, all its content, settings, and languages are deleted, and all users lose access to it. This action is irreversible.To delete a project, follow the instructions for archiving projects, but click Delete instead of Archive in step 3. Then enter the name of the project you’re about to delete and click Delete project.
Moving a project under a different subscriptionSubscription admins of both the original and the target subscriptions can move a project between subscriptions using project cloning.
Assets and content items in archived projects don’t count toward your usage.
Should you clone your project or create environments?Although project cloning and environments work similarly, they serve different purposes.
Use environments to prepare changes in a safe space before going into production. Your developers then take care of propagating those changes to production.
Use project cloning to create new standalone projects for content creation. For example, if you want to run projects based on a similar content model but with slightly different content.
Avoid changes during copyingMaking 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.
Create projects based on a templateAnother 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 subscriptionSubscription admins of both the original and the target subscriptions can move a project between subscriptions using project cloning.
. If you’re on the free trial plan, this option is disabled for you, and your data will be automatically stored in the default data center, which is located in the East US.
Project settings > General > Project name.
The changes are saved automatically.
.
