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

Map suitable permissions

Is this page helpful?
Complete and continue
  • Sign in
  • Tomas Nosek, Martin Turena
    5 minutes
    Users & Roles
    In Kontent.ai, every user is assigned a role that defines their permissions within the platform. Role permissions cover all critical aspects, from viewing content to managing content types. This lesson explains the importance of mapping out how your organization works now or will work in the future before setting up your team’s roles.

    Why mapping permissions is important

    Knowing who will work on each task and where the responsibilities lie is crucial. Without clearly understanding who's doing what, incomplete tasks and bottlenecks can hinder your content creation efforts. A Copywriter, Editor, Graphic Designer, System Administrator, and Developer are just a few roles that access content and content software within a company. Yet, it is unlikely for all the roles to need the same permissions. By setting up roles in your company, you'll connect communication silos and enable your company to work effectively with content.

    How to map permissions

    Let's identify responsibilities from the permission areas' point of view:
    • The administration permissions –  for the configuration and maintenance of the content project
    • The content permissions – for working with the content within the project
    Although there might be some overlap, the goals of the respective areas are quite different. Let’s imagine a typical front office. When a customer walks in, the product they are looking for is information on products or perhaps assistance with them. But to achieve that goal, there needs to be a physical building first, with a convenient environment inside. If there is an issue with the office layout or the Internet goes down, it’s not your front office specialists who address the problem. The online project you're building follows the same pattern. Let your content specialists focus on what they can do best, and as far as maintenance goes, let your developers or strategists shine. These are typical tasks that fall into the two respective areas:
    AdministrationContent
    Configure and update the content modelView content
    Manage users, roles, and workflowsCreate content
    Manage subscription plansEdit content
    Manage APIsDelete content

    Who’s suitable for administration permissions

    These permissions are typically for administrators and developers of your project. At the beginning of your project implementation, those are also the people that will have access to Kontent.ai first. The predefined Project manager role is a good start as its permissions are unlimited. This way, everyone that’s in the project from the beginning can explore the possibilities of Kontent.ai.  For further implementation and later production phases, it's useful to assign these permissions only to those who need to change core properties and are aware of their impact. Changing content types, managing APIs, and other permissions may break your apps if mishandled.

    Subscription admin

    The only users that have more permissions than the Project manager are the Subscription admins. Subscription admins are users that have full permissions over the subscription that contains the project. These permissions include changing the subscription plan and payment details. The Subscription admin is the Project manager in all the projects within the subscription to guarantee full permissions over the whole Kontent.ai configuration. For the Subscription admin, choose the content owner at your company, the technical owner of Kontent.ai, or both. As Subscription admins can delete projects, do not use the admin for more users than needed.

    Who's suitable for content permissions

    The smaller your content-related team is, the easier your content permission model will be. In such cases, it's typical to let people access most of the content and allow them to do nearly all actions with the content as their tasks overlap. However, with more complex teams and more content produced, you'll typically divide people into groups that will always be allowed to create, modify, or delete specific parts of your content only. To do that, it's important to understand your organization and how you’d like your content teams to interact. Try to answer this list of questions:
    Answers to those questions are now the base for your content permission setup.
    What's next?
    Design roles
    When identifying roles, it’s essential to have a clear understanding of the users’ responsibilities. By designing such roles for your projects, you’ll be able to clarify what each role is accounted for and what their main tasks are.
    • Your first project
    • Roles and permissions
    • Establish content workflows
    • Website management
    1. Who’s the main content creator?
    2. What content is edited by whom and when?
    3. What is the process of content creation? Which steps does the content go through before it’s published?
    4. What is the approval process before the content is published?
    5. How will the respective team members collaborate? Will they be expected to pick content for editing, or will specific content be assigned to them?
    • Map suitable permissions
    • Design roles
    • Configure roles
    • Set up permissions
    Publishing permissionsIf you're looking for publishing permissions, those are part of the workflow. Workflows contain steps that indicate the state of your content item. The next learning path dives deeper into workflows and how you can use them to establish publishing permissions effectively.
    See what each permission allows in the role permission reference.
    Allow changes to assigned content onlyIn Kontent.ai, you can assign content directly to users. If your team’s strategy involves assigning specific tasks to specific people, you can configure that in roles as well. For example, an external contributor, such as a translator, doesn't need to see or modify all content. You’ll rather pick and choose what content the translator is supposed to work on and once complete, you will assign other content to them.
  • Why mapping permissions is important
  • How to map permissions