Skip to main content
Last Reviewed: March 28, 2023

Choosing Your Start State

See available options for starting new Drupal or WordPress sites and site import considerations.

Select the site's framework during the site creation process. Pantheon Upstreams provide default installations of WordPress, Drupal (Latest Version), and Drupal 7.


Drupal 8 reached end-of-life status in November 2021, and is no longer supported by Drupal. Read the official announcement on

Custom Upstreams are available to team members when the Workspace is associated during site creation.

Pantheon Upstreams

We base our Drupal repositories on the canonical source from We extend Drupal 7 sites with Pressflow modifications and additional features to take advantage of the Pantheon runtime environment that is automatically included in the Drupal Latest Version. The WordPress repository includes platform integration plugins and a pre-configured wp-config.php file.

Empty Upstream

An empty Upstream is a Custom Upstream that does not have any content or code:

Use an empty Upstream to host a static site or files on Pantheon.

Public Distributions

We make a growing number of Drupal products available in Upstreams on Pantheon. These products are also known as installation profiles or distributions and contain much more functionality than a Drupal core installation.


If the distribution you are using is behind on core releases or any of its included plugins, please contact the maintainer through or the distribution's GitHub issue queue.

Use the following direct links to create a new site on Pantheon from a public distribution:

Product UUID

There is a UUID for all the different systems you can install on Pantheon. WordPress on Pantheon is e8fe8550-1ab9-4964-8838-2b9abdccf4bf. To see all available products, run the following Terminus command:

terminus upstream:list --all

Create Sites with Terminus

Create new sites with Terminus, the Pantheon CLI. Run terminus site:create <site> <label> <upstream> to create a new site using the desired upstream:

terminus site:create my-new-panopoly-site "My New Panopoly Site" "Panopoly"
 [notice] Creating a new site...
 [notice] Deploying CMS...
 [notice] Deployed CMS
terminus dashboard:view my-new-panopoly-site

Import an Existing Site

Your site migration has four phases. You’ll package your site, import it, test it out, then change DNS and go live. With a good plan and understanding of the platform, the process will run smoothly. For detailed information, see Migrate Sites to Pantheon.