Projects

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.
• In the project templates listing, you will only see active projects in which you are the subscription admin, and these projects need to be under the Scale plan or higher.

To create a new project:

1. In Kontent.ai, click your initials in the bottom left corner.
2. Select Projects.
3. Click Create new project in the top right corner.
4. Type the name of the project.
5. Select a subscription for the project.
6. Select a data center for your data.
7. (Optional) Select an existing project to be used as a template.
8. Click Create project.

Create a sample project

To see a fully-featured project with a website and mobile app, you can create a sample project.

1. In Kontent.ai, click your initials in the bottom left corner.
2. Select Projects.
3. At the end of the list, choose which sample project you want.
   1. For a single-brand sample project, click Create complete sample project.
   2. For a multi-brand sample project, click Create multi-brand sample project.
4. Select a subscription for the project.
5. Click Create project.

Once you have your own sample project, you can use it to run our sample apps or build your own app.

Rename projects

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:

1. In Kontent.ai, click your initials in the bottom left corner.
2. Select Projects.
3. For the project you want to archive, click .
4. Select Archive.

Restore projects

1. In Projects, select the Archived tab.
2. 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.

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 the Include content items and assets checkbox.
8. 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:
  • 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

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.