Last Reviewed: 2026-09-16

Get Started with Pantheon

Add a Site

Create or migrate a site on Pantheon.

Discuss in Slack

Edit this page on GitHub Report an issue with this doc

There are dozens of ways to add a site on Pantheon. This section covers the most common scenarios for new users: creating a new CMS site (a site running WordPress or Drupal), or migrating an existing WordPress or Drupal site. For additional scenarios, see the Adding a Site to Pantheon section at the end of this document.

Create a New CMS Site

Pantheon CMS site contains three components: code, files, and a database containing the content and configurations of your Content Management System (CMS). When you create a site, you are creating each of these components in the Dev environment. Then, when you are ready, you will create your Test and Live environments.

Create the Dev Environment

To create a CMS site:

1. Go to the workspace and select the Create New Site button:

   

2. Select WordPress or Drupal.

   

   If you select Drupal, you will have the option to select the Drupal version you want to use.

   

3. Select where you want to host the codebase for this site. For external repositories, use GitHub or GitLab. Otherwise, select Pantheon.

   

4. Enter the following information and click Create site:

   • Sitename
   • Select a region for this site.
   • If this site is to be part of a Professional Workspace, select a Workspace from Choose a Workspace for the Site.

   

5. The deployment process begins. It can take several minutes to create a new site on Pantheon.

   

   Information:

   Note

   You can navigate away from this page during this process, but later, you'll have access the site via the Sites tab in your Workspace.

6. Click Go to site dashboard when the process is complete.

   

You've now created the core portion of your Dev environment; now you have to install the CMS.

Install the CMS

1. Click Dev admin.

2. You will be presented with either a Drupal or WordPress setup screen. You may also see an interstitial warning message when visiting an environment for the first time.

3. Enter the information on the screen, and when done, return to the browser tab containing your Site Dashboard.

   Information:

   Note

   Be sure to record your new username and password. You will use this to log in to your CMS in all environments (Dev, Test, Live).

You have successfully finished adding a site in its Dev environment. Click Dev site to view your site.

Create the Test environment

To create your Test environment:

1. Go to the Site Dashboard.

2. Click the Test tab, then click Create environment to create your Test environment.

   

   This takes a few moments.

You have successfully finished adding a site in its Test environment. Click Test site to view your site.

Create the Live environment

After you purchase a plan, you can deploy your site live. But first, you have to create the Live environment.

To create your Live environment:

1. Go to the Site Dashboard.

2. Click the Live tab.

3. Click Create environment to create your Live environment.

   

You have successfully finished adding a site in its Live environment. Click Live site to view your site.

At this point, you have a live site with a Pantheon URL, like http://my-site.pantheonsite.io/. To change that to a more friendly URL, you'll need to purchase a domain from a DNS provider. Refer to our Domains on Pantheon Guide for more information.

Create a Site with external repositories

Pantheon's external repositories integration connects a GitHub or GitLab repository directly to a Pantheon site, allowing you to use your preferred VCS provider as your code repository while Pantheon handles hosting and deployments. It supports WordPress, Drupal, and Next.js, and automatically creates a Multidev environment for each pull request or merge request. Merging to the main branch of your repository deploys code to your Pantheon Dev environment.

See the following connection guides to get started with an external respoistory:

• Connect GitHub
• Connect GitLab

Migrate an Existing Site

If you already have a site hosted elsewhere, you can move it over to Pantheon with minimal effort.

Before you Begin

1. Check your plugins and/or modules against Drupal Modules Known Issues and WordPress Known Issues.

2. Make sure your code is compatible with the latest recommended version of PHP for your CMS. If not, be prepared to adjust PHP versions.

3. Remove unneeded code, database tables, and files.

Perform the Migration

You have successfully migrated a site to its Dev environment!

Now it's time to purchase a site plan in preparation for launching your site.

More Resources

• Migrate a Composer Managed Drupal Site from Another Platform
• Import Drush Site Archives with Terminus
• Migrate a Drupal Site from Another Platform
• Manually Migrate Sites to Pantheon
• Create a Static Site Using an Empty Upstream
• Create a Drupal Site Using a Drupal Distribution
• Create a Drupal Site From the Command Line Using Terminus and Drush
• Create a WordPress Site with Terminus and WP-CLI