Projects

Projects allow you to separately manage your feature flags and experiments across your different business units, product lines, and applications. When you first create your account, you're provided with one project named Default. This project 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 project.

The following objects are also located in a project. 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 projects within your account to allow each team to have a separated space to manage their experiments and feature flags. You can manage your projects from your Admin Settings page. Here, you can add new projects or edit existing ones.

Creating projects

To create a project, do the following:

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

2. Click Admin settings, then Projects. The Create a project appears.

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

4. Enter a name for the project.
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 project permissions area, select the desired control access by doing the following:

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

6. Click Create to create a new project.

About setting project permissions

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

Editing a project

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

1. From the left navigation, click on the user’s initials at the bottom.
2. Click Admin settings, then projects. A list of projects appears.
3. On the selected project you want to edit, click View in the Action column.
4. Click the Actions button and then Edit project from the menu list. The Edit project 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 project permissions area, optionally select the desired control access by doing the following:

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

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

Viewing projects

To view projects, do the following:

1. From the left navigation, click on the user’s initials at the bottom.
2. Click Admin settings, then projects. A list of projects appears.
3. Select View on the desired project. From here, you can see the environment name, ID, type of project it is, permissions setting, and data export permission settings.

Requesting access to projects

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

Navigating between projects

You can navigate between projects by doing the following:

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

Managing your projects

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

• See a list of all your existing projects.
• Manage the environments and traffic types in a project by clicking View in the Actions colum for selected projects.