Skip to main content

Changing the owner of a project

Abstract

You can change the owner of a project from the Workspace profile page or from the project's project settings page.

Workspaces own projects. When you add a project to Bitrise, you select the workspace that will act as the owner of the project. From that point, only the owners of the workspace can change the ownership of the project.

It can happen that you need to transfer a project on Bitrise to another workspace. This can be done in two ways:

  • You can select the projects you want to transfer from the Workspace settings page's Projects menu.

  • Any given project can be transferred from the project's Project settings page.

When transferring a project, its custom settings are also transferred. These include:

  • All Workflows and Pipelines.

  • Build triggers.

  • Environment Variables.

  • Build artifacts.

Users on the project's team might lose their access in the event of a transfer.

  • Users of the project who are owners of the workspace that receives the project will retain access.

  • Contributors will be transferred and retain their access if the workspace that receives the project allows outside contributors. If the workspace doesn't allow outside contributors, they will lose their access.

  • Users belonging to groups listed on the Groups tab will lose their access to the project, as the groups belong to the workspace that previously owned the project.

Transferring projects on the Workspace settings page

Owners only

You must be an owner of the Workspace to transfer its projects to another Workspace.

  1. Log in to Bitrise and hover over the left navigation bar.

  2. Make sure you have the right workspace selected in the Workspace menu.

  3. Select Settings.

    workspace-settings-new.png

  4. On the left, select Projects from the menu options.

  5. Click the Move project (↔) button next to the project's name to select a project.

    Projects with outside contributors

    When transferring projects with outside contributors to a Workspace that doesn't allow outside contributors, the existing contributors are automatically removed from the project's team.

  6. Select a user or Workspace to transfer the project to them.

    move-project.png

  7. Click Move project to finalize.

    Transferring ownership is permanent

    Only the new owner can change the project's ownership after the transfer has been completed!

Transferring a project on the Project settings page

  1. Log in with an account that is an owner of the project.

  2. Open the Project settings page.

  3. Select Basic settings on the left and find the Danger Zone label.

  4. Click the Move project button.

    transferownership.png

  5. Select a Workspace to transfer the project to it.

    transferownership_2.png

  6. Click Move project to finalize.

    Transferring ownership is permanent!

    Only the new owner can change the project's ownership after the transfer has been completed!

In this section: