Managing organizations

An organization is an entity with a body of people in a business. Members of an organization have access to a set of entitlements, which are associated with CloudBees product subscriptions, trials, and preview programs. An organization must have at least one admin.

Organization roles and permissions

Your permissions within different organizations may vary depending on your user profile’s assigned roles within an organization. For more information about roles, refer to the Basic role-based access controls section.

User profiles are independent of organization profiles. Users may belong to one or more organizations or may not belong to an organization.

Viewing organization users

You can view a list of users who belong to your current organization on the Users screen. The user list can be filtered by name or by role.

  1. Select the organization name in the upper right corner to display the User profile menu and then select Organization settings.

  2. Select Organization settings  Users in the left navigation.

  3. (Optional) Filter the list using the Filter users search or Role drop-down.

Creating an organization

You can create one or more organizations. Organization names must be unique and have at least one administrator. Any user who creates an organization becomes the default owner and administrator.

The display name forms the basis of the URL used in the domain preview. This domain preview provides a URL you can use to access the organization directly. This URL is in the format, where ORG_NAME is the name of your new organization: https://app.cloudbees.com/~ORG_NAME. The domain preview can’t be manually edited.

To create an organization:

  1. Select the organization name in the upper right corner to display the User profile menu and then select Organization settings.

  2. Select User settings  Organizations in the left navigation.

  3. Select + Create organization.

  4. Enter a name for the organization in Organization display name. You can not use any special characters in the name.

    New organization dialog
    Figure 1. New organization
  5. (Optional) Enter a description.

  6. Select Create.

You may need to sign out and sign back in to select the new organization.

Updating an organization profile

Each organization has a profile that contains information including the display name, domain preview, description, address, and phone number. You can change any field except the domain preview.

To update an organization profile:

  1. Select the organization name in the upper right corner to display the User profile menu and then select Organization settings.

  2. Select Organization settings  Organization profile in the left navigation.

  3. Modify the fields you wish to change.

  4. Select Save.