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

Upstreams on Pantheon

Switch Your Upstream

Learn how to switch your upstream.


This section provides steps to switch an existing site's upstream to a different upstream.

Warning:
Warning

Switching the upstream of an existing site is risky. It is safer to create a new site from your upstream and migrate the contents. Back up your site first and consider our documentation on upstream merge conflicts if you must switch upstreams.

The destination upstream must share Git history with the one the site currently uses (for example, forked from or based on the same repository). A site cannot switch to an upstream with an unrelated commit history.

Switch your upstream

Review the Terminus Switch Upstream example before following the steps below to switch your upstream.

  1. Run the command below to locate your upstream's machine name, replacing $org with your organization name.

  2. Run the command below to change the upstream, setting or replacing the variables $site and $upstream_id with your site name and upstream machine name, respectively.

More resources