One of the benefits of WordPress hosting through WP Engine is the ability to set up a 1-click staging site from your WordPress Admin Dashboard. A 1-click staging site is a copy of your live production site that can be easily created to test plugins, themes, and custom code. You can also copy the 1-click staging site back to the live site at any time after making changes.

Only the current year’s /uploads and /blogs.dir directories are copied. Our system will fallback to Live to find an image if it 404s on Legacy Staging.

Some plugins should not be used in the staging area, specifically those that automate tweeting, posting or emailing.

If you have mapped a custom domain to your production area, be sure to redirect the “environment.wpengine.com” default URL to your custom domain on the Domains page in the User Portal. This will ensure the custom domain is used in the search and replace when copying from Legacy Staging to your Live website.

Plugins requiring a license to validate against your domain will likely have issues. You may need to purchase a second license for Legacy Staging or check with author about a Staging site licensing option.

Copying to and from Legacy Staging always takes place within the WP Engine plugin on the Live site.

The URL structure for every 1-Click Legacy Staging area is: installname.staging.wpengine.com

All existing users’ information is copied, so your login credentials will be the same as they were on Live when you last copied to staging.

Staging and live do not actively sync. If you have added changes to live you will need to copy them back down to staging. It is not advised to modify both sites’ files during the same time period, as changes may be overwritten and lost after a deployment.

The 1-click staging area is not indexed by search engines. The robots.txt file is set to “disallow all” user-agents (bots).

Deploy Live to Legacy Staging

Open WordPress wp-admin

Click on WP Engine plugin on top left

Select Legacy Staging

Click blue Copy site from LIVE to STAGING button

Your site will now be copied to the staging area and a green box will pop-up showing the status. The larger the size of your Live site, the longer it will take to deploy to Legacy Staging.

When your live site has been copied into the 1-click staging environment, you will see a green banner and be given a link to access it.

Deploying Legacy Staging to Live

If you’ve made changes to the staging site and want to push those changes to the live site, you can do so easily. Some important information to note about the Legacy Staging deploy process:

When deploying to live there are 3 database options. Tables cannot be merged, only overwritten.

Move All Tables — Overwrite all tables on live

Select Tables to Move — Overwrite specific tables on live

Move No Tables — Copy no tables to live from staging

You cannot specify which files from the filesystem are pushed.

The legacy file system deployment is non-destructive. This means files updated on staging will overwrite existing files on live. Files deleted on staging will not be deleted on live.

The WordPress core version on staging must match live or the deployment will not start.

To start the deployment to live:

Open WordPress wp-admin

Click on WP Engine plugin on top left

Select Legacy Staging

Click red button Deploy site fromSTAGING to LIVE

Select a Database Mode

Click red button Deploy site fromSTAGING to LIVE

Commonly Excluded Database Tables

If you’ve added content to the live site since the last push to staging and you hope to preserve that data when pushing back, you can exclude that table when pushing to live. Ultimately you may need to refer to the plugin support if you’re not sure which tables hold data you wish to keep.

To select multiple tables, hold CTRL and click the table names.

To deselect a table, hold CTRL and click the table name.

To push all changes except for pages, posts and users to your live site, select all database tables except:

wp_postswp_postmetawp_userswp_usermeta

If you are using WooCommerce the tables WooCommerce stores Order data you may want to exclude from the deployment. It might be a good idea to exclude the user information as well.

NOTE: If you’re using a custom database prefix, these would read yourprefix_tablename instead of wp_tablename.

Access the Legacy 1-Click Staging File System

To access your staging site’s file system, follow the normal instructions for connecting to SFTP.
When creating the new SFTP account, be sure to set the user to the Legacy Staging environment.
You can also edit any existing SFTP user’s settings and change the “Environment” to Legacy Staging

Article Quick Tips

Tip

The Staging Environment has caching disabled, which makes it ideal for testing small changes to your site or testing new plugins and themes.

Tip

We intend for the deploy site tool to replace 1-click staging in the future as we continue adding new functionality to the deploy tool which will make it more robust and flexible. We’ll be sure to give you plenty of notice before we fully replace our 1-click staging functionality, so try out the new deploy site tool today!

Development

Platform Information

Share

Share:

Contact the WP Engine Support Team

In order to get expert one-on-one help, please log into your account so we can identify your account and get you exactly the help you need. We offer support 24 hours a day, 7 days a week, 365 days a year.