Managing Projects

Projects let you organize your workspaces and scope access to workspace resources.

Permissions

You must be a member of a team with the Manage all Projects organization-level permissions permissions to create a project.

You must be a member of a team with the update team access to add a new team access for organization-visible teams for a project.

You must be a member of a team with update and delete permissions to be able to update and delete teams respectively.

View a Project

To view your organization's projects:

1. Click Projects.
2. Search for a project that you want to review by scrolling or searching for a project name in the search bar above the project table.
3. Click on a project's name to view more details.

Create a Project

To create a new project:

1. Click Projects.
2. Click + New project. The Create a new project modal appears.
3. Enter a Project Name. The name must be unique within the organization and can only include letters, numbers, inner spaces, dashes (-), and underscores (_).
4. Optionally, enter a Project Description.
5. Click Create.

HCP Terraform returns a new project page displaying all the project information.

Edit a Project

To edit a project:

1. Click Projects.
2. Click on a project name of the project you want to edit.
3. Click Settings.

On this General settings page, you can update the project name, project description, and delete the project. On the Team access page, you can modify team access to the project.

Delete a Project

You can only delete projects that do not contain workspaces.

To delete an empty project:

1. Click Projects.
2. Search for a project that you want to review by scrolling down the table or searching for a project name in the search bar above the project table.
3. Click Settings. The settings view for the selected project appears.
4. Click the Delete button. A Delete project modal appears.
5. Click the Delete button to confirm the deletion.

HCP Terraform returns to the Projects view with the deleted project removed from the list.