To use this plugin you must first install the Go Live Update Urls plugin which may be downloaded for free:
Once you purchase the PRO version, you will receive a download link for the PRO plugin within the order email. You may also download the PRO plugin anytime by going to the My Account section of this site. Upload the PRO plugin using the standard WordPress plugin installer and activate both the PRO and free plugins.
Here are some step by step instructions.
Once you have entered both the New and Old URL, the plugin will begin to search your database for matching urls and provide a total count of the number of urls which will be updated. A banner will display above the Update Urls button which will look similar to this:
Each section or table will also be counted individually and a total for each will be displayed in the list. Once counting is completed the Status column will look similar to this:
Once you have submitted the changes by clicking the Update Urls button, the plugin will provide a total count of the number of urls which were updated. A banner will display above the Update Urls button which will look similar to this:
Each section or table will also be counted individually and a total for each will be displayed in the list. Once updating is complete the Status column will look similar to this:
All counting is done automatically and will always be reported. Counting is handled one section at time. Real-time counting is indicated by loading icons and status changes in the Status column.
You will find an icon to the right of the New URL field which has a tool-tip to let you know it is for testing. Clicking this icon will run tests against the entered Old URL and New URL. Once the tests are complete, you will be shown a report similar to the image below. If any issues are found, you will be given a button to click to automatically fix the issue. There is no configuration required for this feature to work.
The following conditions prevent the “Verify this site is accessible from the New URL” from being able to reliably verify the site is accessible from the new URL and therefore will always show “Unable to verify whether or not this site is accessible from the new URL”:
- The entered Old URL and New URL are not the same as the current site URL and are not the domain of the current site.
- The site is a multi-site using sub-directories and the entered URLs are specific to a site on the network instead of simply entering the old and new domains.
If the new domain is not yet pointed to the site, the “Verify this site is accessible from the New URL” will always show “This site is not accessible when the Old URL is replaced with the New URL” (which makes sense because the site is not accessible on the new domain if it is pointed elsewhere).
Site Address History
You will find an icon to the right of the Old URL field which has a tool-tip to let you know it is for viewing your Site Address History. Clicking this icon will open a history report similar to the image below. This list will contain any changes made to the Site Address (URL) via your General Settings in the WordPress admin since this plugin has been activate on the site. The results will be limited to the last 10 changes in order of newest to oldest. Clicking the “Use” button at the right of any item will automatically fill out the Old URL and New URL with the values from that row.
This feature is fully automatic. If you have changed the Site Address (URL) via your General Settings in the WordPress admin during the past 24 hours, the Old URL and New URL will automatically be filled out for you with the values of the last change. This will only work if the plugin was active at the time of changing the Site Address, otherwise no configuration is necessary.
Suggested Procedure For Switching A Site’s Domain
- Setup both old and new domains on the server to point to the site.
- Point your host file to the server so you may see the change before the rest of the world.
- You can skip this step if you prefer to point the new domain to the server prior to testing.
- If you DO NOT point the domain to the server prior to testing, the URL testing results will always show the site is not accessible or unable to verify whether or not the domain is accessible (which makes sense because the site is not accessible on the new domain if it is pointed elsewhere).
- Change the WordPress Address (URL) and Site Address (URL) in the WordPress General Settings.
- Run this plugin to change the domain in WordPress.
- Verify everything is working.
- Point to the new domain to the server to make the site live on the new domain (if not done already).
When this plugin is activated, a new WP-CLI command will be available called go-live. You may use this command using standard practices such as:
Command usage may be found using the normal
wp help go-live and
wp help go-live update commands. Otherwise, basic usage is as follows.
To update the entire database simply run
wp go-live update <old url> <new url> replacing <old url> and <new url> with your site’s specific URLs such as:
You may specify particular tables or sections using the
--sections flag. If you specify either tables or sections, the command will let you know which tables were updated once complete.
Tables match what you would normally see on the Go Live setting page. For example, if you want to just update the
wp_users tables you could run the command like so:
Sections use slugs to represent what you see in the Go Live settings page. Available sections include
comments, custom, network, options, posts, terms, user. For example, if you want to just update the
posts you would run the command like so: