Organizations and apps

3 minute read

A CloudBees Feature Management organization is a group of users that are managed by an administrator. Organizations contain one or more apps.

A CloudBees Feature Management app is a group of environments and flags within an organization. We recommend that you use separate apps for each of your products or services.

Do not use multiple apps for one service in different server states. Instead, use a single CloudBees Feature Management app with multiple environments.

You can scale your feature flag settings and user permissions for organizations and apps, and you can belong to one or more organizations and apps.

You can create an unlimited number of apps. You can also filter and/or sort your apps to quickly find a specific app.

Creating an organization

Refer to CloudBees Feature Management Pricing to create a new account.

The first time you sign in to a new account, you are prompted to create a new organization. You can create one CloudBees Feature Management organization per email account.

To create a CloudBees Feature Management organization:

  1. Sign in to an account that is not part of any organization.

  2. In the Join an organization screen, select Create organization.

  3. Enter a unique Organization display name, and optionally enter a Description.

  4. Select Create.

    Your new organization is created, and you are signed in.

To switch between organizations, select your email and avatar from the upper-right corner of the CloudBees Feature Management Home page, and then select the organization.

If you need further assistance, select Need our help? from the bottom-left corner of any screen within CloudBees Feature Management or contact CloudBees Support.

Creating an app

You must be an organization administrator to create an app.

You can create an unlimited number of apps within an organization.

To create an app:

  1. From the CloudBees Feature Management Home page, select your email and avatar, and then select the organization. Disregard this step if you are a member of only one organization.

  2. Select All apps from the left pane.

  3. Select Create app below your email and avatar.

  4. Enter the app name, and then select Create.

Your new app is created, and displayed in the default environment. The app is also listed in All apps.

Filtering and sorting apps

Apps can be filtered and sorted in ascending or descending order, or by Last updated. Sorting can be performed with or without filtering. The default sort order is Last updated.

To filter and/or sort your apps:

  1. From the CloudBees Feature Management Home page, select All apps from the left pane.

  2. Under Filter apps, enter text to perform a filter.

  3. Under Sort by, select Last updated, Name A-Z or Name Z-A to perform a sort.

The app list is sorted and/or filtered accordingly.

Updating app information

You can rename an app and add/update an icon for the app.

To edit the app information:

  1. From the CloudBees Feature Management Home page, select your email and avatar, and then select the organization. Disregard this step if you are a member of only one organization.

  2. Select All apps from the left pane, and then select the app.

  3. Select App settings Information.

  4. You can enter text under Application name to update the app name. The app name updates instantly. You can select Upload icon to upload an image file from your files, from the web, or from your computer’s camera.

The app name and/or the icon is updated on the left pane and on Home All apps.

Managing custom properties

You can create your own custom properties that can be used when Defining Target Groups or in the Audiences tab as criteria for feature releases. Custom properties can be created either in the CloudBees Feature Management UI or your source code. If you add a custom property to your code and run/compile the application, it will automatically be available in CloudBees Feature Management.

Refer to Custom Properties to learn more.

Deleting an app

All CloudBees Feature Management organizations must have at least one app. You can delete any app from an organization as long as another app remains.

If you attempt to delete the sole remaining app, you cannot delete the app, and the following warning is displayed: This is the last and only application in your organization. It cannot be deleted.

To delete an app:

  1. From the CloudBees Feature Management Home page, select your email and avatar, and then select the organization. Disregard this step if you are a member of only one organization.

  2. Select All apps from the left pane, and then select the app.

  3. Select App settings Delete app.

  4. Select Yes, I understand and accept the risks associated with this action.

  5. Select Delete.

Your app is now deleted. A deleted app has all flags set to false.

To invite users and manage permissions, refer to Managing organization permissions and Managing app permissions.