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.

NOTE

Need to move ownership of an environment that is not transferable to another WP Engine account? Reach out to WP Engine Support.


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 Sites 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 Sites can be identified by the arrow icon next to the name in the User Portal.

NOTE

If adding a new Site and it can only be created as transferable, the account has reached the Site limit. Delete extraneous Sites or upgrade the plan’s Site limit.

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.

NOTE

Do not change the password for a transferable environment until the environment has completed its initial set up.

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
  1. Click Next, and complete the other required creation details, such as entering a name.

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
  1. Select Copy an environment – This will duplicate the existing environment into the new transferable site.
  1. Select the source environment from the list
  2. 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.

NOTE

Only individual environments can be transferred to another plan. To make an entire site (including its environments) billable on the current plan, see the steps for unlocking a site instead.

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
  1. Enter the client’s email in the field labelled Recipient Email
  2. (Optional) Enter a Note to the recipient
    • For example, provide a link to this article or a contact phone number.
  3. Click Send Code
    • This code will expire 30 days after being generated, for security purposes.
  1. 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:

NOTE

The environment will not be removed from the plan until the recipient has entered the transfer code into their own WP Engine plan and completed the Accept Transfer process.

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
  1. On the following page, locate Accept a transfer of a site and select Get Started
  1. 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.
  2. Click Next
  3. 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

Transfer to Another Account I Manage

If your WP Engine user account has access to multiple hosting accounts, transferable sites can now be transferred more easily between them. You user must have Full with Billing or Owner level user access to both accounts in order to transfer a Site with this option.

This process will transfer the entire Site (including any Production, Staging, and Development environment) and unlock it on the destination account.

This process can only be used when transferring Sites from a Shared account to another Shared account. The accounts must be within the same region, as migrations cannot be performed automatically.

  1. From the Sites page, select the environment name to transfer
  2. Click Transfer to another account I manage
  3. Select the destination account name
  4. Click Transfer site

NEXT STEP: Learn how to add Sites and Environments

Need more Sites?

Each Site includes Development, Staging, and Production environments. Get more Sites for your account as an add-on without upgrading your whole hosting plan.