Create organizations and organizational units#

Organizations and organizational units (or units) can be used to group projects and apply common settings like authentication and teams (user groups). For details and recommendations on creating hierarchical organizations in Aiven, see Organizations, projects, and managing access permissions.

Create an organizational unit#

You can create an organizational unit within an organization to group your projects by things like your departments or environments. To create an organizational unit:

  1. In the organization where you want to create an organizational unit, click Admin.

  2. In the Organizational units section, click Create organizational unit.

  3. Enter a name for the unit.

  4. Select any projects that you want to assign to this organizational unit. You can search for projects by name.

  5. If you want to invite admin users to the unit, set the toggle to Yes and enter their email addresses. They will receive an email invitation with a confirmation link.

    Important

    Admin have full control over the organizational unit and the projects assigned to it.

  6. Click Create organizational unit.

Your organizational unit is shown in the Organizational units section. Click the unit name to view and manage it’s teams and projects.

Note

Only one level of nesting is supported. This means that organizational units cannot be created within other units.

Create an organization#

Important

We recommend using only one organization and creating organizational units to group your projects.

Creating a new organization requires you to manually configure organization-level settings again such as billing groups, authentication settings, and teams.

  1. Click the user information icon and select Organizations.

  2. On the Organizations tab of the User profile, click Create organization.

  3. Enter a name for the organization.

  4. Select any projects that you want to assign to this organization. You can search for projects by name.

  5. If you want to invite admin users to the organization, set the toggle to Yes and enter their email addresses. They will receive an email invitation with a confirmation link.

    Important

    When admin users accept the invitation, they are added to the default team that has full control over the organization and the projects assigned to it.

  6. Click Create organization.

The Admin page opens, where you can add organizational units, and manage teams, projects, and other settings.