Organizations and Organization Users Overview

      Organizations and roles help you manage access to Couchbase Capella software and services.

      This page provides overview information about organizations and organization users and their role in helping you manage access to Couchbase Capella.


      Couchbase Capella uses an ordered hierarchy to help you keep all of your data organized and securely accessible. The entity at the top of the hierarchy is called an organization. Everything you do in Capella — whether it’s creating a cluster or managing billing — happens within the scope of an organization.

      Since billing happens at the organization level, an organization typically represents a company, and the organization’s users typically represent the company’s employees and contractors. However, an organization can represent any entity that handles payment for Capella services and doesn’t necessarily have to be a business.

      Administering Organizations

      For information on how to create, modify, and delete organizations, refer to Manage Organizations.

      Organization Users

      To access an organization, your Couchbase Capella user account must be added to it. Accounts are added to an organization using email invitations sent from the Capella by a user with the Organization Owner organization role. All organization users are given one or more organization roles that define what they can view and manage in their organization.

      If you create a Capella account without being invited to an existing organization, you will need to create a new organization. When you create an organization, your account is automatically added as the first organization user and is assigned the Organization Owner role. With this organization role, you can invite additional Capella user accounts to become members of the organization.

      Organization roles provide access to the Capella UI. They are separate from project roles which grant granular privileges to projects, clusters, and data tools. Organization roles are also distinct from database credentials, which grant programmatic and application access to cluster data.

      Managing Organization Users

      For information on how to add, configure, and remove organization users, refer to Manage Organization Users.