Organizations and sub-organizations

Organizations, the base grouping of the CloudBees platform, allow users to represent their own access hierarchy. A step below organizations in the hierarchy are sub-organizations, available only to users with a paid subscription plan.

A tenant organization in the CloudBees platform is the default organization a user or subscriber to the platform is provided. For a free plan account, this is the only available organization. Users with a paid plan account can create unlimited children, or sub-organizations.

These powerful features ensure that users have access to only configurations they need, reducing cognitive load and improving security.

For example, a top-level organization could represent a company or large division, and sub-organizations could represent product teams, with the root nodes representing the individual applications and services being built by those teams.

Access and switch to an organization tenant

Your current organization is displayed above the left pane. To be a member of an organization, an organization administrator must first grant you access.

List your organization tenants

If access to an organization has been granted to you, the organization is displayed in your organization list. Display your listed organizations by either of the following ways:

Select the to the right of the current organization.
Select your account name on the upper right, then select Edit account to display your organizations. Enter all or part of an organization name into Search to filter for specific organizations.

Switch to a different organization tenant

To switch to a different organization, you must already be a member of that organization.

To switch to a different organization:

Select the to the right of the current organization.
Select an organization from the list.

Your selected organization is displayed as the current organization.

Inheritance and override rules

A sub-organization has visibility into anything declared or visible in the parent organization, unless explicitly overridden.

Create a sub-organization

The sub-organization feature is only available to paid subscription plan users.

Create a sub-organization in either of the following two ways:

From CREATE SUB-ORGANIZATIONS:
1. Select ORG SETTINGS to the left of your account name, then select Organization profile.
2. Select the SUB-ORGANIZATIONS tab to the right of PROFILE.
3. Select CREATE SUB-ORGANIZATION.
4. Select the parent organization or sub-organization.
5. Select NEXT.
6. Enter a Name and an optional Description.
7. Select CREATE.

Or:

From the parent organization:
1. Select ORG SETTINGS to the left of your account name, then select Organization profile.
2. Select the SUB-ORGANIZATIONS tab to the right of PROFILE.
3. Select the organization or sub-organization you want your sub-organization to be a part of.
4. Select the , then select Create.
5. Enter a Name and an optional Description.
6. Select CREATE.

Update an organization or sub-organization profile

Update the name or description of an organization or sub-organization.

To update an organization or sub-organization:

Switch to the organization.
Select ORG SETTINGS to the left of your account name, then select Organization profile.
(Optional) To update an organization, update the Organization name and/or optional Description.
(Optional) To update a sub-organization:
1. Select the SUB-ORGANIZATIONS tab to the right of PROFILE.
2. Select the next to the sub-organization you want to update.
3. Select Edit.
4. Update the Name and/or optional Description.
Select SAVE.

Your organization or sub-organization profile is updated accordingly.

Delete a sub-organization

A deleted sub-organization is completely removed from the CloudBees platform, and deletion is irreversible. All child sub-organizations and components are also deleted.

To delete a sub-organization:

Switch to the organization.
Select ORG SETTINGS to the left of your account name, then select Organization profile.
Select the SUB-ORGANIZATIONS tab to the right of PROFILE.
Select the next to the sub-organization you want to delete.
Select Delete.
Select DELETE.

Your sub-organization is deleted, including all of its child sub-organizations and components.