Transferable Sites and Environments

Transferable sites and environments allow developers to build a website without counting towards the total site limit on their WP Engine plan. Once completed, transferable sites and environments include an easy path to transfer them to another WP Engine plan. In this article we will explain how to create a transferable site, how to transfer an environment to a client successfully, and how to unlock a transferable site without transferring.

---

What is “transferable”?

Every WP Engine plan has the ability to create essentially infinite transferable sites and environments at no additional charge.

Each transferable environment has traffic blocked through basic authentication (password protection), and cannot receive live production traffic. Therefore transferable sites do not count against the plan’s total site limit. Be aware however that other plan limits, like local disk storage, will continue to count towards the total plan usage.

To remove the transferable status, and convert a website into a regular, billable instance; a Site can be unlocked (remain on the current account) or an environment can be transferred (moved to another account).

• Only individual environments can be transferred (Production/Staging/Development).
• Only Site’s can be unlocked, which will subsequently unlock all environments within it (Production/Staging/Development).

For a refresh on the difference between a “Site” and an “environment” review our guide here.

Transferable Specifications

Transferable sites differ from billable sites in a few ways:

• Transferable sites do not count against the plan’s site limit. Storage, visits, and all other metrics will still contribute to the plan’s limits.
• Transferable environments are transferable to any another WP Engine plan with sufficient space on their plan through an automated process.
• Transferable environments are automatically password-protected to block traffic. The password cannot be removed until the transfer or unlock is complete, however it can be changed.
• Transferable environments are automatically exempt from server cache due to password-protection.
• Transferable environments can have a custom domain added when the environment is set as Production (PRD) within the site.
• Transferable environments cannot have SSL added.

---

Transferable Password Protection

Transferable environments are password protected behind basic authentication. This additional login prevents the website from being taken live and receiving real traffic. Because the environment is not billable, the basic authentication login cannot be removed until the environment is transferred to another plan or unlocked on the current plan.

This password can be changed, however, in order to make logging in easier, or if the login has been shared for review and needs to be changed for security reasons. The user name will always be demo and cannot be changed.

To change the transferable password, click the pencil icon next to the password on the Overview page for the environment in the User Portal. The username cannot be changed.

---

Create Transferable Site

A “site” is the grouping of three environments (PRD, STG and DEV) and will need to be created before adding a transferable environment. Both the site “container” and the individual environments within it will be transferable.

To make a transferable site:

1. From Sites page, click Add site
2. Any of the following creation options will allow the site to be created as transferable:
   • Build a new site
   • Migrate a site
   • Copy or move an environment
3. On the next page, under “Site Owner” select Someone else will own it

5. Click Next, and complete the other required creation details, such as entering a name.
   • For more information in site creation options, see the full “Create Site” guide.

That’s it! An email will be sent once setup is complete and work can begin on the new transferable site.

The basic authentication credentials can be found any time on the Overview page for the environment in the User Portal.

Convert to Transferable

If you’ve already begun working on a non-transferable website and need to convert it to transferable later, use the following steps:

1. From the Sites page, click Add site
2. Choose Copy or move an environment
3. On the next page, under “Site Owner” select Someone else will own it

4. Select Copy an environment – This will duplicate the existing environment into the new transferable site.

5. Select the source environment from the list
6. Fill in the additional creation details, then click Add site.

This process will duplicate the environment onto a new one one that is transferable. The original non-transferable site/environment can be deleted once this is complete, if necessary.

---

Transfer Environment

Use the following steps to transfer an environment to a client’s own WP Engine plan. Initiating a transfer requires Owner or Full (with billing) permissions on the originating WP Engine plan. Owner or Full user permissions are required to accept a transfer on the receiving plan.

Initiate Environment Transfer

Before beginning this process, ensure the recipient has their own WP Engine plan with available sites. If the recipient does not have available sites on their plan they will need to delete an existing site or upgrade to accept the transfer.

1. From the Sites page, select the environment name
2. Click Transfer environment

3. Enter the client’s email in the field labelled Recipient Email
4. (Optional) Enter a Note to the recipient
   • For example, provide a link to this article or a contact phone number.
5. Click Send Code
   • This code will expire 30 days after being generated, for security purposes.

8. The recipient will receive an email with instructions on how to accept the transfer, as well as the custom note. This email will look similar to the following example:

Accept Environment Transfer

The recipient of a transfer will need to enter a transfer code in the User Portal to complete the transfer process.

Accepting a transferable site on an plan requires Full (with or without Billing) level user access to that plan in the User Portal.

1. Log in to the User Portal under the plan receiving the transfer
2. From the Sites page, click Add Site

3. On the following page, locate Accept a transfer of a site and select Get Started

3. On the next page, Enter transfer code will display. Paste in the Transfer code from either the email or copied from the transfer initiation form.
4. Click Next
5. Follow the prompts to confirm the transfer, such as selecting the destination site and granting any users access.

Transfer Code

The transfer code is sent via email to the specified recipient when a transfer is initiated. It can be found at the top of the email, as shown in this example:

Alternatively, if a user has access to both the sending and receiving plan, the transfer code can be copied and pastes into the receiving plan via the User Portal. The transfer code in this case can be generated on the Transfer Environment form prior sending the transfer email.

---

Unlock a Transferable Site

Unlocking a transferable Site will remove the transferable status, making it billable on the account. Unlocking a transferable Site is different than transferring a Site because unlocking will keep the site on the same, current hosting account. The entire Site will be unlocked, removing the transferable status of all environments within it.

A “billable” site is allowed to serve live traffic by removing basic authentication and grants the ability to add a domain, CDN, and SSL. Additionally, converting to a billable Site means it will count towards the plan’s total site limit.

1. From the Sites page, locate the site name in the list
2. Select the gear menu icon to the right
3. Select Convert to billable site
4. Click Convert in the pop up

---

NEXT STEP: Learn how to add Sites and Environments