Workspaces

Workspaces allow you to separately manage your feature flags and experiments across your different business units, product lines, and applications. When you first create your organization, you're provided with one workspace named Default. This workspace has two environments and one traffic type created underneath it. You can rename and edit these environments and traffic types and add more to the Default workspace.

The following objects are also located in a workspace. Refer object model map below for reference:

• feature flags
• segments
• metrics
• event types
• API keys

When you onboard different business units to Split, you can add up to 20 workspaces within your organization to allow each team to have a separated space to manage their experiments and feature flags. You can manage your workspaces from your Admin Settings page. Here, you can add new workspaces or edit existing ones.

Creating workspaces

To create a workspace, do the following:

1. From the left navigation, click on the user’s initials at the bottom.

2. Click Admin settings, then Workspaces. The Create a workspaces appears.

3. To create a workspace, click Create workspace at the top right. The Create workspace page appears.

4. Enter a name for the workspace.
5. On the Required comments checkbox, optionally check whether you’re requiring titles and comments for feature flags, segments, and metric changes.

Note: When you check this box, it affects approval flows.

6. In the Workspace permissions area, select the desired control access by doing the following:

• Anyone has access. Allows anyone to have access to this particular workspace.
• Restrict who can access. Allows you to select which users, groups, and Admin API keys have access to a particular workspace.

7. Click Create to create a new workspace.

About setting workspace permissions

You can set view permissions to your workspaces or workspaces you have administrator rights to and any objects within the workspace. This allows you more granular control over which users, groups, and API keys can access the objects in workspaces to support access requirements within an organization. These objects include feature flags, segments, metrics, traffic types, and environments. This also allows you to determine who can see if a certain Workspace exists.

Editing a workspace

When you are viewing a workspace, you can edit a workspace by doing the following:

1. From the left navigation, click on the user’s initials at the bottom.
2. Click Admin settings, then Workspaces. A list of workspaces appears.
3. On the selected workspace you want to edit, click View in the Action column.
4. Click the Actions button and then Edit workspace from the menu list. The Edit workspace page appears.

5. In the Name field, optionally change the name.
6. On the Required comments checkbox, optionally check whether you’re requiring titles and comments for feature flags, segments, and metric changes.

Note: When you check this box, it affects the approval flows.

7. In the Workspace permissions area, optionally select the desired control access by doing the following:

• Anyone has access. Allows anyone to have access to this particular workspace.
• Restrict who can access. Allows you to select which users, groups, and admin API keys have access to a particular workspace.

8. Click Save to save your changes. The changes appear in the admin audit logs.

Viewing workspaces

To view workspaces, do the following:

1. From the left navigation, click on the user’s initials at the bottom.

2. Click Admin settings, then Workspaces. A list of workspaces appears.

3. Select View on the desired workspace. From here, you can see the environment name, ID, type of workspace it is, permissions setting, and data export permission settings.

Requesting access to workspaces

If you have no access to a workspace, you need to request access from the administrator of that workspace.

Navigating between workspaces

You can navigate between workspaces by doing the following:

1. From the left navigation, click on the workspace’s initials at the top.
2. Search or select the workspace you would like to switch to. You can see the environments, feature flags, segments, and metrics under that workspace.

Managing your workspaces

To manage your workspaces, go to the Workspaces tab in your Admin Settings page. On this page you can:

• See a list of all your existing workspaces.
• Manage the environments and traffic types in a workspace by clicking View in the Actions column for selected workspaces.