Skip to main content
Last Reviewed: 2026-03-11

How to transfer a site between Pantheon workspaces

Prepare your Next.js site for transfer between Pantheon workspaces by linking the VCS connection.

Discuss in Slack
Edit this page on GitHub Report an issue with this doc

This guide walks through transferring a Next.js site from one Pantheon workspace to another. When a site is transferred, the VCS connection must also be linked to the destination workspace.

Note

The actual site transfer between workspaces must be performed by Pantheon support. This guide covers the prerequisites you must complete before requesting the transfer.

Requirements

  • Administrative access to both the source and destination Pantheon workspaces
  • Terminus

Before requesting a site transfer, you must link the VCS connection to the destination workspace. Run:

Replace:

  • <destination-workspace> with the name, label, or ID of the destination Pantheon workspace
  • <github-org> with the GitHub organization name where the app is installed
  • <source-workspace> with the name, label, or ID of the source Pantheon workspace that has the existing VCS connection
Note

If you omit --vcs-org or --source-org, the command prompts you to select from available options interactively.

You can verify existing connections by running:

Step 2: Request the site transfer

Once you have linked the VCS connection to the destination workspace, contact Pantheon support to request the site transfer. Provide the following information:

  • The site name or ID
  • The source workspace name or ID
  • The destination workspace name or ID

Step 3: Verify

After Pantheon support completes the transfer, confirm:

  1. The site appears in the destination workspace.
  2. Push a small change to the repository and verify it triggers a build on the site.

GitHub User accounts

When the GitHub App is installed on a personal GitHub account (rather than a GitHub organization), the installation is only accessible to the user who created it. This means the user who originally installed the GitHub App must be the one to run the vcs:connection:link command.

If that user is unavailable, contact Pantheon support for assistance.