Projects
Projects let you organize and manage feature flags, experiments, metrics, and more for a specific team, business unit, or application in Harness FME. Harness recommends creating one project per team, business unit, or independently managed application domain.
Use a single project when teams need to share feature flags, metrics, environments, or visibility across services.
Use separate projects when teams require isolated RBAC, independent release cadences, or strict separation of feature flag and experimentation data.
Projects in Harness FME are hard partitions for feature flag and experimentation data. Related flags (such as parent-child or flag prerequisites) and metrics that rely on the same event streams must exist within the same project. If you only need lightweight organization within a shared domain, consider using naming conventions and tags instead of creating separate projects.
When you first create your account, Harness FME provides a default project named Default. The Default project includes two environments and one traffic type.
You can rename and edit the default environments and traffic type, and create additional resources as needed. Projects contain and scope the following resources:
Create a project
Project creation in Harness FME uses the Harness platform project workflow. After creating a project, return to FME Settings to configure FME-specific options.
To create a project:
From the FME navigation menu, click FME Settings and select Projects.
Click Create project at the top right.
This opens the Projects page under FME Settings in the FME navigation menu.
Click + New Project.
Complete the following details:
Enter a name for the project.
Select a color option for the project.
Optionally, enter a description and add tags.
Click Save and Continue.
Optionally, invite people to collaborate in the project by selecting a role from the dropdown menu (like
FME Manager) and adding collaborators in your organization by email address.
Click Save and Continue.
Next, click FME Settings.
Click View under Actions on the project you created (for example,
Documentation).
Click on the Actions dropdown menu and select Edit project.
Select the Required title and comments comments toggle to enable requiring titles and comments for feature flags, segments, and metric changes.
Click Save.
Manage projects
You can manage projects in FME Settings and the Projects page.
Configure project settings
In FME Settings, you can configure whether project changes require titles and comments for auditability and change tracking.
To configure project settings in Harness FME:
Navigate to FME Settings > Projects.
Click View for the project you want to configure.
Open the Actions dropdown menu and select Edit project.
In the Edit project dialog, enable or disable Require title and comments for feature flag, segment, and metric changes.
Click Save.
When enabled, users must provide a title and comment when modifying feature flags, segments, or metrics within the project. This can help improve change tracking and audit visibility across teams.
Delete a project
DELETE FME RESOURCES BEFORE DELETING THE PROJECT
Deleting a Harness project removes the associated Harness module resources within that project. However, Feature Management & Experimentation (FME) resources are not automatically deleted.
Before deleting a project, manually remove associated FME resources such as feature flags, segments, metrics, environments, and traffic types.
To delete a project:
Navigate to FME Settings > Projects.
Click View for the project you want to delete.
Open the Actions dropdown menu and select Delete project.
This redirects you to the broader Harness Projects management page for your organization.
Find the project, click the kebab menu (⋮), and select Delete.
In the Delete Project dialog, select Yes, I want to delete this project.
Still using `app.split.io`?
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.
Each Split project has a project permissions setting which you can use to restrict access to that project to specific users, groups, or API keys. If a user, group, or API key is not granted access to a restricted project, they cannot see the project name nor determine whether that project exists.
Project view restrictions can be used to protect sensitive (i.e., confidential) projects, or to improve user experience by showing a small number of relevant projects to each user.
Viewing or updating project permissions
An Admin can view or edit a project's permissions by following these steps:
Navigate to Admin settings.
On the Projects page, click the View link for a project.
Click the Actions button on the top left and select Edit project. The Edit project pane will appear.
On the Edit project pane, you can view project permissions. You can also restrict access to the project to some users, groups, and Admin API Keys.
To manage project-level settings:
Click Actions > Edit project in the top right corner of the Projects page.
In the Edit project pane, enable the Require comments toggle to enforce titles and comments for changes to feature flags, segments, and metrics.
In the Project permissions section, optionally select the desired control access from the following options:
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.
Click Save.
Editing a project
When you are viewing a project, you can edit a project by doing the following:
From the left navigation, click on the profile button at the bottom.
Click Admin settings, then Projects. A list of projects appears.
On the selected project you want to edit, click View in the Actions column.
Click the Actions button and then Edit project from the menu list. The Edit project page appears.
In the Name field, optionally change the name.
Enable the Require comments toggle to enforce titles and comments for changes to feature flags, segments, and metric.
In the Project permissions section, optionally select the desired control access from the following options:
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.
Click Save to save your changes. The changes appear in the admin audit logs.
Viewing projects
To view projects, do the following:
From the left navigation, click on the profile button at the bottom.
Click Admin settings, then Projects. A list of projects appears.
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:
From the left navigation, click on the profile button at the top.
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 column for selected projects.
Deleting a project
To delete a project, follow these steps:
Make sure all feature flags, segments, and metrics are deleted from the project for all environments.
To delete a feature flag, delete all the definitions from its environments.
Then, delete the feature flag.
To delete a segment, first select all its keys.
Then, delete the keys.
Then, delete the segment definition and repeat these steps for all environments.
Finally, delete the segment.
To delete metrics, click on the upper top right (...) icon to delete it.
In the Admin page, under the API keys page, Make sure all Admin API and SDK keys are revoked for the project environments. For example the screenshot below shows the SDK API key for the "default" project.
In Admin settings, in the left menu, click Projects.
In the list of available projects, click the View link of the project you want to delete.
You will see a list of environments for the selected project, now you can delete each environment using the Delete link.
The user interface will allow you to delete all environments except the last one, as each project is required to have at least one environment.
Click the Actions button in the top right corner and choose the Delete project option, which will allow you to delete it.
Last updated
Was this helpful?