How To Setup A WordPress Staging Website
It's never a good idea to make "live edits" to your WordPress website when you want to make big changes such as adding a new theme.
The solution is to setup a staging site using a subdomain so you can make you changes, tweak everything, and then port it back to the live site once it's ready.
Anytime you go messing with your file structure, you always want to take a full backup of your account incase something goes wrong.
While we do take nightly backups at Name Hero (as long as your account isn't over 100K inodes/20GB of space) you still shouldn't substitute these for your own backups.
There are many different ways to go about this, but the best in my opinion is to take a full cPanel backup.
You do this by going to cPanel -> JetBackup 5 -> Full Backups
You can select the most recent backup then hit the Download button.
If this isn't an option, you can always manually download all the files using a FTP program such as Filezilla and then download the database backup from cPanel -> Backup.
Regardless how you go about it, you NEVER want to skip this step.
Once your files are safe and secure it's time to setup a staging subdomain.
You do this by going into cPanel -> Domains.
Click on Create a New Domain
Enter your Staging Subdomain on the domain field. (e.g. "staging.yourdomain.com")
Uncheck the box for "Share document root"
The other fields will be auto-populated. You can leave the default values as is.
Then hit Submit.
Once created you may need to wait a bit for the DNS to propagate. Following these instructions may speed up the process, or you may just wish to use another browser window.
WordPress has two parts: files and database. They work together to produce your website.
You first want to copy over all your existing files to the subdomain you create.
You can easily do this by navigating to the directory where WordPress currently resides (most often your public_html): cPanel -> File Manager -> public_html
Once here you want to select all the files and folders (left click at the top, hold shift, and left click at the bottom).
You then want to click the "Copy" button on the top menu:
And then enter the location of your staging subdomain and click Copy File(s):
Once completed, you can verify they all moved over by navigating to the staging directory inside of File Manager:
Once the files have been copied it's time to copy over your existing database.
You need to know the database name so you may want to check your current wp-config.php file for that name if you don't already know it.
Then go to cPanel -> PHPMyAdmin -> Click On Your Database:
Then click on the Operations tab at the top -> and enter a new database name under Copy database to and click Go:
Once completed, you need to click on the "Options" table of the staging database and change the siteurl and home values to reflect the staging subdomain:
Finally, you need to re-assign the database user to have permissions to work inside the staging database.
You can do this by going to cPanel -> mySQL Databases and then adding the user with all privileges:
Make sure to update your wp-config.php file with the new database information.
Congratulations! At this point, you're ready to go to your "staging" WordPress admin (i.e. http://staging.yourdomain.com/wp-admin) and begin making your edits.
Once you're finished up editing your staging site, you can easily re-import everything by following the same steps outlined above, but in a bit of a different order:
Backup everything (you can remove the original backup)
Copy the files from the staging website to the live website
Edit the "Options" table (in your new database) to reflect the live domain (i.e. http://www.yourdomain.com vs. http://staging.yourdomain.com)
Remove the staging subdomain / original database to keep your file structure clean
You're all set!
Notice there is no real need to re-import the database, you can simply make the "staging" database the new one.
I know some of our customers like to use WordPress plugins to accomplish this; and that's fine if you can get them to work.
Personally, I've always been really cheap, and hate to pay for other services when I can do it with a couple clicks inside of cPanel. I've also run into timeout errors which can be extremely frustrating when trying to move large amounts of data in the browser.
The solution is to setup a staging site using a subdomain so you can make you changes, tweak everything, and then port it back to the live site once it's ready.
Take A Backup
Anytime you go messing with your file structure, you always want to take a full backup of your account incase something goes wrong.
While we do take nightly backups at Name Hero (as long as your account isn't over 100K inodes/20GB of space) you still shouldn't substitute these for your own backups.
There are many different ways to go about this, but the best in my opinion is to take a full cPanel backup.
You do this by going to cPanel -> JetBackup 5 -> Full Backups
You can select the most recent backup then hit the Download button.
If this isn't an option, you can always manually download all the files using a FTP program such as Filezilla and then download the database backup from cPanel -> Backup.
Regardless how you go about it, you NEVER want to skip this step.
Setup Staging Subdomain
Once your files are safe and secure it's time to setup a staging subdomain.
You do this by going into cPanel -> Domains.
Click on Create a New Domain
Enter your Staging Subdomain on the domain field. (e.g. "staging.yourdomain.com")
Uncheck the box for "Share document root"
The other fields will be auto-populated. You can leave the default values as is.
Then hit Submit.
Once created you may need to wait a bit for the DNS to propagate. Following these instructions may speed up the process, or you may just wish to use another browser window.
Copy Your Existing Files
WordPress has two parts: files and database. They work together to produce your website.
You first want to copy over all your existing files to the subdomain you create.
You can easily do this by navigating to the directory where WordPress currently resides (most often your public_html): cPanel -> File Manager -> public_html
Once here you want to select all the files and folders (left click at the top, hold shift, and left click at the bottom).
You then want to click the "Copy" button on the top menu:
And then enter the location of your staging subdomain and click Copy File(s):
Once completed, you can verify they all moved over by navigating to the staging directory inside of File Manager:
Copy Your Existing Database
Once the files have been copied it's time to copy over your existing database.
You need to know the database name so you may want to check your current wp-config.php file for that name if you don't already know it.
Then go to cPanel -> PHPMyAdmin -> Click On Your Database:
Then click on the Operations tab at the top -> and enter a new database name under Copy database to and click Go:
Once completed, you need to click on the "Options" table of the staging database and change the siteurl and home values to reflect the staging subdomain:
Finally, you need to re-assign the database user to have permissions to work inside the staging database.
You can do this by going to cPanel -> mySQL Databases and then adding the user with all privileges:
Make sure to update your wp-config.php file with the new database information.
Congratulations! At this point, you're ready to go to your "staging" WordPress admin (i.e. http://staging.yourdomain.com/wp-admin) and begin making your edits.
How To Re-Import Your Website
Once you're finished up editing your staging site, you can easily re-import everything by following the same steps outlined above, but in a bit of a different order:
Backup everything (you can remove the original backup)
Copy the files from the staging website to the live website
Edit the "Options" table (in your new database) to reflect the live domain (i.e. http://www.yourdomain.com vs. http://staging.yourdomain.com)
Remove the staging subdomain / original database to keep your file structure clean
You're all set!
Notice there is no real need to re-import the database, you can simply make the "staging" database the new one.
I know some of our customers like to use WordPress plugins to accomplish this; and that's fine if you can get them to work.
Personally, I've always been really cheap, and hate to pay for other services when I can do it with a couple clicks inside of cPanel. I've also run into timeout errors which can be extremely frustrating when trying to move large amounts of data in the browser.
Updated on: 10/10/2024
Thank you!