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

Upstreams on Pantheon

Edit an Existing Upstream

Learn how to edit your upstream settings.


This section provides information on editing an existing upstream.

Update name or description

Follow the steps below if you want to change the name or description of your upstream.

  1. Navigate to your workspace dashboard, then select the Upstreams tab.

  2. Next to the existing upstream requiring an update, click the dropdown icon and then click Edit settings.

  3. Make desired changes, then click Save.

Update repository credentials

You can update the access token used to authenticate to your private repository — a GitHub personal access token or a Bitbucket repository access token — directly from the Dashboard:

  1. Navigate to your workspace dashboard, then select the Upstreams tab.

  2. Next to the existing upstream requiring an update, click the dropdown icon and then click Edit settings.

  3. In the Repository credentials section, click Update credentials (or Add credentials if none are set yet), enter the new credentials, then click Save.

Update repository URL

You cannot modify the repository URL on an existing upstream. We recommend creating a new upstream if there is a new URL you need to use.

Warning:
Warning

To switch existing sites to the new upstream, it must share Git history with the one they currently use (for example, forked from or based on the original repository).

A site cannot switch to an upstream with an unrelated commit history.

Review Switch Your Upstream before switching.

You will need to switch each site to the new upstream individually with Terminus:

You must merge changes as a one-click update after a site's upstream is changed. Review Example Usage for more details.

You can safely delete the old upstream after all sites have been updated to track the new upstream. Review Delete an Upstream for more information.

More resources