Kontent.ai
Copyright © 2023 Kontent.ai. All rights reserved.
  • Web
  • Privacy policy
  • Cookies policy
  • Consent settings
  • Security
  • GDPR
  • Documentation
  • API reference
  • Product updates
Kontent.ai Learn
  • Plan
  • Set up
  • Model
  • Develop
  • Create

Projects

Is this page helpful?
  • Sign in
    • Jan Cerman
    11 minutes
    Projects
    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.
    • 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

    If you want to see a fully-featured project with a website and mobile app, you can create a Sample Project. The Sample Project contains marketing content for Dancing Goat – an imaginary chain of coffee shops.
    1. In Kontent.ai, click your initials in the bottom left corner.
    2. Select Projects.
    3. At the bottom of the list, click Create complete 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

    Want to change a project name? If you’re a subscription admin, you can rename the project at any time.
    1. In Kontent.ai, click the left drop-down at the top to select a project.
    2. For the project you want to rename, click Project settings.
    3. In Project settings > General > Project name, type a new name.
    The changes are saved automatically.

    Archive projects

    Only subscription admins can archive projects.

    What happens with archived projects?

    When you archive a project, its content cannot be accessed anymore, and all Kontent.ai APIs for that project are disabled. Here’s a list of the most important things that are disabled after archiving:
    • The Delivery API will be disabled. This may break live applications that retrieve content from the project.
    • All contributors on the project will be deactivated and won’t count towards your current usage (unless some of those contributors are still active in other projects).
    • No one will be able to access the project anymore until you activate it again.
    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 More actions.
    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 to 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. 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 More actions.
    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 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 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.
    Creating a new project in Kontent
    Changing the project name
    Archiving a project
    Cloning entire project
    • Docs
    • Collections
    • Custom elements
    • Environments
    • Keyboard shortcuts
    • Projects
    • Spaces
    • Task management
    • Terminology
    • Web Spotlight
  • Create projects
  • Create a sample project
  • Rename projects
  • Archive projects
  • Restore projects
  • Clone projects
  • Delete projects
    • 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.
    Content items and assets in archived projects don’t count toward your usage.
    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.