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

Collections

Is this page helpful?
  • Sign in
    • Jan Cerman
    11 minutes
    Collections
    Collections set boundaries for your content items. They let you simplify the organization of your content according to your business structure and needs.

    Add a collection

    1. In Environment settings > Collections, click Create new collection.
    2. Type the new collection name.
    3. Click Confirm.
    4. Click Save changes in the top-right corner.
    You can have as many collections as you want.

    Rename a collection

    1. In Environment settings, select Collections.
    2. Click the collection you want to rename.
    3. In Collection name, adjust the name.
    4. Click Confirm.
    5. Click Save changes in the top-right corner.

    Assign user role permissions for collections

    By default, new users have a single role for content in all collections and languages. If you’ve already mapped and established roles for your users, you can assign your users to work on content in specific collections and languages.
    1. In Environment settings, select Users.
    2. Click a user to open their details.
    3. In Collection, select one or more collections.
    4. In Role, select a role.
    5. (Optional) In Language, select one or more languages.
    6. Click Save.
    If you want to assign different roles for specific collections, click Assign roles for another collection in the user details. You need Advanced collections in your plan to assign roles in collections.

    Examples of role permissions

    Users can have different roles for each collection. For example, Antonio has the Editor-in-Chief role for the US branch and UK branch collections. In any other collections, he has the External contributor role that allows him only to view content.
    You can also connect permissions to the languages. For example, Sofia is an Editor-in-Chief for Spanish content. Her role applies only to the Global collection. This means that, unlike Antonio above, Sofia can’t view content in other collections.

    Move items between collections

    Every content item can be moved under a single collection. Your choice of the collection also applies to all variants of the item.
    1. In Content & assets, open a content item for editing.
    2. In the Content details sidebar, click the current collection under Collection.
    3. From the drop-down list, select another collection.
    4. Click Move.
    The item moves to the new collection immediately.

    Govern assets with role permissions in collections

    You can assign assets to collections to improve your content governance. You set up the role permissions for assets in a similar way you set up roles for content items. For greater flexibility, the permissions for assets are set separately from those for content items.
    After you set up asset permissions for your roles as needed, assign the roles in collections to users in your project.

    Assign assets to collections

    For assets you already have in your asset library:
    1. In Content & assets, go to the asset library.
    2. Open an asset’s details.
    3. Select a collection in the Collection card in the main section.
    4. Click Save changes.
    When you upload new assets, you’re asked to assign them to a collection right after the upload.

    Remove assets from a collection

    You can choose to have assets without a collection. When you upload a new asset, use the ∅ Not in collection option in the collection selection modal to leave the new asset without a collection. If you’ve already assigned assets to a collection, you can remove them from the collection:
    1. In Content & assets, go to the asset library.
    2. Open an asset’s details.
    3. Select the ∅ Not in collection option in the Collection card in the main section.
    4. Click Save changes.

    Bulk operations on assets in collections

    You can both assign assets to and remove them from collections in bulk:
    1. In Content & assets, go to the asset library.
    2. Select the assets you want to assign to or remove from a collection.
    3. Click Move asset to collection in the menu bar above the asset grid.
    4. Select the desired option:
      • Select a collection to assign the assets to it.
      • Select the ∅ Not in collection option to remove assets from their collections. You can use this even if the selected assets are in various collections.
    5. Click Change.

    Roles of users are set up per language and collection
    Roles of users are set up per language and collection
    • Docs
    • Collections
    • Custom elements
    • Environments
    • Keyboard shortcuts
    • Projects
    • Spaces
    • Task management
    • Terminology
    • Web Spotlight
    Set up permissions for content items and assets
    Assign an asset to a collection
    Select a collection after asset upload
  • Add a collection
  • Assign user role permissions for collections
  • Move items between collections
  • Govern assets with role permissions in collections
    • You can rename multiple collections and click Save changes only once after the last change.
    About Any collection and Any languageIf you choose Any collection or Any language for a role, the role applies to collections and/or languages that don't have any specific role assigned to them. This includes collections and/or languages that you add in the future.
    Requirements for moving items between collections
    • You are assigned to the collections you want to move between.
    • In both collections, you have the Edit permission for the content types of the selected items.
    • In both collections, you have the Edit permission for all translated variants of the selected items.
    Need to move several items at once?In Content & assets, select a few content items. Then click More actions > Change collection.
    Is it safe for us to start using assets in collections?Sure it is! The permissions for assets work the same as with content items. If a role has access to only one collection, users with that role can’t see assets in other collections. They do, however, see all assets without collections, as they did before.
    You can’t have assets without a collection in new blank projects created from scratch.