Organization is the top-most entity in the hierarchy of entities in Contentstack. Users, stacks—and consequently, the resources within the stacks—are part of an Organization. As a result, an Organization lets you manage users and stacks from one administrative panel.
Organizations serve two main purposes:
The Organization feature is primarily for administrators. It lets them manage roles and permissions for the users and stacks of the account.
If you own or are part of multiple Organizations, your stacks will reside in the respective Organizations they were created in.
To switch from one organization to another, click the ‘ORGANIZATION’ tab in the header, and select the Organization that you wish to access. Once selected, you will be able to see the stacks of the Organization.
In order to work on a stack, a user must be part of the Organization that contains the stack. Note that a user cannot be directly invited to a stack without also being invited to an Organization. Learn how to invite a user to an Organization.
In Organizations, three predefined roles are available that can be assigned to a user: Owner, Admin, and Member. Custom roles cannot be created in an Organization, however, customer roles are still available and can be created for stacks. Let’s understand the three predefined roles in detail.
The Owner is the user who owns the Organization (and the subscription plan) in Contentstack. The Owner has maximum privileges, which includes the ability to:
A user with the Admin role is next in the hierarchy. This role has all the rights that the Owner enjoys, except access to billing details and the right to transfer ownership. The permissions for this role include:
Note: Only the owner and admins have the rights to create stacks in an organization.
Next in the hierarchy is the Member role. The rights of the role can be modified by the Owner or the Admin user. The user with the Member role does not have access to the Organization settings panel. Therefore, details such as Organization info, usage metrics, and so on are not visible to this user. The rights of this role include:
In this section, you can find all the details and settings related to your Organization. This section is visible only to the Owner and Admin users of the Organization. To access settings, click on the Organization name visible on the header. Hover on the name of the Organization (visible in the dropdown list) of which you want to access the settings, and click the ‘settings’ icon that appear. You will be redirected to the page from where you can manage the settings.
Here, you can find the ‘Name’ and the ‘ID’ of the Organization. These details cannot be modified.
Note: To modify these details, you can contact our Support team.
‘Transfer Ownership’ lets you transfer the ownership of the Organization to any other user. To do this, click on ‘Transfer Ownership’ and enter the email address of the user you wish to transfer ownership to.
This will send an email invitation to the user to accept ownership of the Organization. Once the user accepts the invitation, you will be assigned the ‘Member’ role, with access to only the stacks that you have created or that were share with you.
The ‘Analytics’ section provides an overview of how the users of your organization are using Contentstack. It also provides details on your subscription plan (i.e., maximum limits, expiry date).
Note: The ‘Analytics’ page can be accessed by only the owners and admins of the organization.
Let us take a look at the various sections of the ‘Analytics’ page.
The ‘Usage Overview’ section provides an overview of the usage, along with the maximum allowed limit, of different types of entities within your organization, such as stacks, content types, entries, assets, and users.
This section gives a quick overview of the usage of various entities by the stacks of your organization. Some of the specifics mentioned include Stack Name, API Key, Owner, Content Types, Entries, Assets, Languages, Environments, Users, Roles, Webhooks, API Calls, and Bandwidth.
Note: This section provides the number of API calls made for a stack within the last 30 days. It also specifies the bandwidth used by the different API calls run over the network (in GB) over the last 30 days.
This section provides details on the usage of various types of APIs (Content Delivery, Content Management, Images, and Assets). It provides the count of calls as well as the bandwidth used (in GB) for each type of API.
The ‘Top URLs’ section highlights the most frequently hit API URLs, along with the number of times those URLs were called.
Using filters, you can view the API Usage data for specific stacks or for a specific duration. Let’s learn more about these filters.
Duration: This filter gives you quick options to view data of the last 30 days, last 14 days, and last 7 days or last 1 day. The Custom option lets you select a custom date range within the last 30 days.
Stack: Use this filter to view API Usage data of only specific stacks. You can choose either a single stack or all stacks at a time.
The ‘Users’ section displays all users in the Organization. It also lets you add and manage users in the Organization.
Click ‘Invite User’ located in the top right-hand side corner of the page. In the new page that appears, enter the email address and the Organization role that needs to be assigned to the user. Only the Owner and the Admin users can invite new users, and only ‘Admin’ and ‘Member’ roles can be assigned to the new users.
Once you assign a role, you can share any stacks in the Organization with the user by selecting the role that you wish to assign for the stack. Finally, click ‘Invite’ to invite the user.
Note: If users are invited to an Organization, they won’t be able to do anything if they aren’t added to any stacks.
For Single Sign-On (SSO) enabled organizations, the process of inviting users works similarly. The only difference is that if ‘Strict Mode’ is disabled for your SSO organization, you may get an additional checkbox ‘Allow access without SSO’ on this screen. Checking this box ensures that the invited user can access the SSO-enabled organization using his/her Contentstack credentials, instead of IdP credentials. Read more.
To remove an existing user from the Organization, hover over the user and click on the vertical ellipses to the right. Click ‘Remove’ and confirm your decision to remove the user from the Organization.
Once a user is removed from an Organization, he/she will lose access to all stacks contained in it.
To change the role of a user, click on the user from the list to open the 'Update User' page. Change the role of the user as required and click on 'Update'.
Here, you see the list of all the stacks created under the currently selected Organization.
From this page, you can perform the below action.
To delete a stack, hover on the stack, click on the vertical ellipsis that appear on the right, and click 'Delete'. Confirm your decision to delete the stack permanently.