Sites and Environments

At WP Engine, a “site” refers to the grouping of three environments: production, staging, and development. These environments allow you to customize your development workflow or troubleshoot issues separately and safely.

For example, if your production website has an issue, you can easily copy to staging and troubleshoot and resolve the issue. Another option is to use development to create and test a new design, when you’re ready you can copy those changes to production. These environments all work independently which means you’ll never have to worry about changes to one environment impacting another.

---

About Sites

A site is an easy way to group several environments together under one name. This streamlines the process of organizing and deploying the related environments for a website.

Environments can also be easily copied within a site using the “Copy environment” tool.

You can only add a custom domain to the production environment in order to take it “live”. Staging and development environments can be used for your development workflow, and cannot have a custom live domain mapped.

Create Site

A “site” refers to the the container for related environments. Site names can be changed at any time and do not need to be unique.

If this is the first site on your account, you may be prompted to select a data center where your website will be hosted. Learn more about our data centers here. In general, we suggest selecting the location closest to the bulk of your customers.

1. Log into the User Portal
2. On the Sites page click Add Site

3. What type of site would you like to add? Select Get Started below one of the following options:
   • (Most common) Build a new site – Build a new WordPress site from scratch. This allows several additional options:
     • Option 1: A fresh install of WordPress, including the Genesis Pro theme.
     • Option 2: A fresh install of WordPress, including items from a preset template, such as a Genesis Pro starter site or a WooCommerce site.
   • Migrate a site – Move a site hosted elsewhere to WP Engine.
     • See the full migration automated migration process here.
     • Learn how to manually migrate a site here.
   • Copy or move an environment – Copy or move an environment from an existing site to this one.
     • Learn more about the copy process here.
   • Accept a transfer of a site – Accept a transferable environment from another WP Engine account.
     • Learn more about transferable environments here.

4. Site Owner – This site will either create the site as billable (counts towards your plan) or transferable (does not count towards plan and cannot be taken live). Select one of the following options:
   • (Most common) I will own it – The site will be created as billable on your account.
   • Someone else will own it – Create the site as transferable, to be added to your plan as non-billable prior to transferring it to another WP Engine account.

5. Click Next
6. Site Details – Define details for this site as well as the first environment within the site.
   • Site Name – The site’s name does not need to be unique and can be changed later
   • Type – Select what type the first environment will be assigned within this site. Each site can include up to three environments:
     • PRD (Production) – Intended to be taken live. Allows a custom domain to be added, as well as SSL and CDN.
     • STG (Staging) – Optional sandbox, typically used for testing. Cannot be taken live.
     • DEV (Development) – Optional sandbox, typically used for testing. Cannot be taken live.
   • Environment Name – Name the first environment within the new site. The name must be unique and cannot have been used before.
7. Click Add Site

That’s it! The site and new environment will begin setting up. You will receive an email once the setup has completed.

---

Edit Site Name

Sites, unlike environments, can have their names changed at any time. To change a site’s name there are two options; Quick Actions and Overview. Both options function the exact same way, so use whichever is easier for you.

Quick Action Edit

1. Locate the Site name on the Sites page of the User Portal
2. Expand the Quick Actions 3 dot menu to the right of the site name
3. Select Edit site name

Overview Edit

Alternatively, the Site name can also be edited from the Overview page of any environment that is within that Site.

1. Open the “Overview” page for the Site by clicking its name on the “Sites” page
2. Locate the Site name in the top menu
3. Expand the dropdown 3 dot menu icon ...
4. Click Edit site name

Delete Site

Deleting a Site also deletes every environment (PRD, DEV, STG) within it. Be sure you have any backups or copies created before deleting a Site. There are two ways in which a Site can be deleted.

Only “Owner” level User Portal users can delete Sites.

Quick Action Delete

1. Locate the Site you wish to delete on the Sites page
2. To the right of the Site name, click the 3 dot menu icon: ...
3. Select Delete site
4. You will be asked to confirm deletion by typing the site name.

Overview Delete

1. Log in to the User Portal
2. Click on the Site name listed on the Sites page
3. Locate the Site name in the top menu
4. Click the quick actions 3 dot ... menu icon
5. Select Delete Site
6. Confirm deletion by typing the name of the Site

---

About Environments

Environments are individual instances of WordPress. This means you can work on an environment independently and without impacting other environments. There are three types of “environments”: Production (PRD), Staging (STG) and Development (DEV).

You can add a total of three environments per site with no additional charge, as WP Engine plan limits are per site and not per environment.

Domains

They will all share the same default URL structure environmentname.wpengine.com using their respective unique environment name.

For shared plans (Lite, Startup, Growth, Scale) only the PRD environment can have a live/custom domain mapped to it. On Premium plans, any of the three environments can have a custom domain added to it.

It is standard for staging and development environments to use different domains than your production environment. If you are using a premium service that issues license based on domain, and require that to also be used on multiple environments, you may need to purchase additional licenses for each environment or inquire about staging services. Some premium services that authenticate based on domain will also offer a staging mode.

Server Configuration and Media

Each environment has the exact same default server configuration and caching, which make them useful for accurate testing and building. Be aware, however, that any custom redirect, cache exclusions or Nginx rules do not copy between these environments.

When using LargeFS, media is stored off-site which means these files cannot be copied by our server. A fall-back rule can be put in place by Support on any necessary STG/DEV environments, or media can be copied in Amazon S3.

---

Create Environment

When a site is first created, you’ll be prompted to add a new environment to it automatically during the process. You will receive an email once the environment has been set up. If you are copying from an existing environment, this process can take some time to complete.

Add Environment to Existing Site

If you already have a site, you can add additional environments using these steps.

1. Log in to the User Portal
2. Click the site name listed on the Sites page
3. Locate the dropdown containing the environment name at the top
4. Click Add production environment, Add staging environment or Add development environment from the menu

Alternatively, in the secondhand navigation,

Next you’ll be prompted to fill in a name, environment type, and other setup options.

You will receive an email once the environment has completed the setup process. If you are copying from an existing environment, this process can take some time to complete.

---

Delete Environment

Deleting an environment will not impact any other environments on your account or within the site. Before deleting an environment be sure to download a backup point. For security purposes, only Owner level users can delete environments.

Environment names cannot be reused, even when the original environment has been deleted.

There are two ways to delete an environment:

Quick Action Delete

1. Log in to the User Portal
2. Locate the environment name listed on the Sites page
3. Click the 3 dot quick actions menu ... to the right of the environment name
4. Select Delete Environment
5. Confirm deletion by typing the name of the environment

Overview Delete

1. Log in to the User Portal
2. Click on the environment name listed on the Sites page
3. On the far right, locate and click Delete environment
4. Confirm deletion by typing the name of the environment

---

NEXT STEP: Learn how to copy an environment