Skip to content
Install

Manage a project

A project groups apps, databases, and jobs in an organization. Project membership controls who can access those resources, so two people in the same organization can see different projects. Each member has a project role of admin, member, or viewer.

  1. Press CMD + K on macOS or CTRL + K on other systems.
  2. Select New project.
  3. In Project name, enter a name.
  4. Select Create project.
  1. Open the project.
  2. Select Members.
  3. Select Add people.
  4. In Find people to add, find each person.
  5. Select Next.
  6. In Role, select a role.
  7. Select Add <name>.

Invitations that are not accepted yet appear under Invitations. Each invitation shows its expiry date. To cancel an invitation, select the delete icon on the invitation.

To remove a member, select the delete icon on the member. The person loses access to the project.

  1. Open the project.
  2. Select the Customize icon in the project header.
  3. Update Name, Description, Icon, or Background.
  4. Select Save.

To turn off the animated background in your browser, refer to Set your preferences.

The project owner’s resource allowance pays for everything in the project. A transfer moves that cost to another member’s allowance, and the new owner must accept it. For the rules and CLI commands, refer to Transfer project ownership.

  1. Open the project.
  2. Go to Settings > Danger zone.
  3. In Transfer ownership, select Transfer.
  4. In New owner, select a member of the project.
  5. Select Send request.

The row shows Waiting on the new owner to accept. until the request ends.

You must be an owner or admin of the organization the project is in, and be able to create projects in the destination organization. If the project would put the destination organization over its limits, you must also be an admin there.

  1. Open the project.
  2. Go to Settings > Danger zone.
  3. In Move to another organization, select Move.
  4. In Organization, select the destination.
  5. In Slug, confirm the project slug. The slug must be free in the destination organization.
  6. Read the preview of what changes.
  7. Select Move project. If the preview shows New database backups stop, this button is Move anyway.

The preview can show these messages:

MessageMeaning
<n> members lose accessThese members are not in the destination organization.
You become the ownerThe current owner is not in the destination organization. The project counts against your allowance.
Over <organization>’s quotaThe move goes through, but new deploys in the destination can be blocked until there is room.
New database backups stopThe destination has no backup storage. Databases keep running, but they take no new backups. Existing backups stay restorable.
Backups keep runningDatabases start to archive to the destination’s backup storage. Existing backups stay restorable.
  1. Open the project.
  2. Go to Settings > Danger zone.
  3. In Delete project, select Delete.
  4. Select Delete project forever.