Transferring Apps

Last updated 21 August 2019

You can transfer applications between Heroku accounts or to a team of which you are a member at any time via the Heroku Dashboard or the Heroku CLI command apps:transfer. Billing responsibility will transfer to the new owner as of the time of accepting the transfer and the original owner will be responsible for pro-rated usage up until that point. After the transfer is complete, the original owner will be a collaborator on the app.

If you are looking to transfer all apps within a pipeline and want to keep the pipeline intact you should use the pipeline ownership transfer. This will transfer the pipelines ownership including all apps within it. Transferring individual apps within a pipeline will remove them from the pipeline and it will need to be re-created by the new owner.

Initiate transfer

Only the application owner can initiate a transfer request.

Apps can be transferred to a collaborator on the app. If the user is not a collaborator, first add them as a collaborator. If you can’t see the team that you want to transfer the app to, then you must ask the team admin to add you to the team.

To initiate the transfer of the application using the CLI, use apps:transfer. For example:

$ heroku apps:transfer -a <app-to-transfer> <collaborator-to-transfer-it-to@example.com>

If you need to transfer multiple apps, use the --bulk flag:

$ heroku apps:transfer --bulk <collaborator-to-transfer-it-to@example.com>
? Select applications you would like to transfer (Press <space> to select, <a> to toggle all, <i> to inverse selection)
❯◯ myapp (heroku)
 ◯ myotherapp (heroku)

To initiate the transfer of the application using the Dashboard:

  1. In Dashboard, click the Settings tab of the application.
  2. Scroll down to the “Transfer Ownership” section.
  3. Click the “Select a new owner” field. The list of people who are collaborators on the app and the list of Teams and Organizations to which you belong will be displayed.
  4. If you don’t see the person you want to transfer the app to, then you must first add them as a collaborator. If you can’t see the team that you want to transfer the app to, then you must ask the team admin to add you to the team.
  5. Select an item from the list.
  6. Click “Transfer.”

To initiate a transfer of one or more applications from a Team to another Team using the Dashboard:

  1. In Dashboard, click the team name of the team you would like to transfer apps into
  2. Click the “Transfer apps” button
  3. Use the select box to select apps from your personal apps list, or another team’s apps list
  4. Select the apps you would like to transfer to the team
  5. Click “transfer apps.”

Accept transfer

The new owner can receive the transfer by accepting the pending transfer request at the top of the dashboard, once it’s initiated:

Acceptance

As the new owner, you will have the option to accept or decline all transfer requests. If the app has an ongoing cost, such as paid add-ons or dynos, then you will be asked to enter in a credit card before accepting, if you haven’t done so already.

Note that you will also be asked to enter your credit card information if verification is required.

Cancel transfer

The owner can cancel the transfer request at any time before the new owner accepts or declines the request.

Downtime

The application will continue to run during a transfer - no downtime is initiated. When transferring a personal application to an Enterprise Team, the dyno type of the application may need to be adjusted, which will require a standard application restart.

Feedback

Log in to submit feedback.