Skip to content Skip to sidebar
Updated
August 27, 2025

Learn how to set up WPML properly when you create a copy of your site or migrate it to a new domain.

Copying or moving your site affects your WPML site key, automatic translation, and Advanced Translation Editor features.

To set up WPML correctly on your new site, follow two essential steps:

  1. Complete WPML’s migration wizard. WPML automatically detects changes to your site’s URL and shows you a migration wizard on your new site’s dashboard.
  1. Re-register the new site with a new site key. This allows you to assign automatic translation credits to the new site from your wpml.org account.

1. Completing WPML’s Migration Wizard

When you see the banner with the migration wizard, there are two options:

Option 1

Click on Start Migration if you are:
Option 2

Click on I just logged in from a secondary domain if you:
Moving your site: For example, moving from development to production.

Copying your site: For example, creating a staging/testing environment.
– Have multiple domains pointing to the same site, and you logged in via one of the secondary domains.

Use this button to avoid unnecessary migration as WPML won’t unregister your secondary domain.
wpml migration wizard first step
WPML’s migration wizard banner

Start the Migration Wizard

The Migration wizard starts when you click on Start Migration. WPML automatically detects:

  • If your original site still exists or not.

Based on this, WPML determines if you’re doing a move (original site doesn’t exist) or a copy (original site still exists).

If WPML can’t detect your original site, it asks you to confirm if it’s a move or a copy.

  • If you have automatic translation credits or subscription on your original site

This case only applies to site copies. When WPML detects credits, it asks if you want to share them between new and original site using a migration code.

step to add migration code in the migration wizard
Share credits between original and new site via migration code

How To Get The Migration Code

When WPML’s migration wizard asks you to add a migration code, it’ll point you to a link where you can get the code. This link takes you to the Translation Tools page on the original site. Expand the Connected Sites section and copy the code.

2. Re-registering Your Site

WPML automatically unregisters the new site, when you copy or move it. After completing the migration wizard, you see a banner asking you to re-register the site.

banner asking a new site key for registering the new site
Re-registering your new site via a new site key

Simply get a site key from the link on this banner and paste it into the text field. 

Your new site is now registered with its own site key, and you’re able to manage automatic translation credits as before.

Results of Site Migration Via WPML’s Migration Wizard

The following table summarizes each case’s implications for WPML’s automatic translation and the Advanced Translation Editor.

Move site to new URLCopy site with migration codeCopy site without migration code
What happens to the original site?No longer in use.Still running.Still running.
How are automatic translation and the translation editor affected?You can translate on the new site only. On the old site, you won’t be able to use the Translation Dashboard or the WPML translation editor.You can translate as normal on both sites.You can translate as normal on both sites.
What happens to automatic translation credits?Automatic translation credits are moved to the new site.Automatic translation credits are shared between sites.Credits aren’t shared, so you need to add credits or activate pay-as-you-go separately on the new site.
What happens to translation information (e.g. memory, glossary)?All translation information is moved to the new URL.Translation information is shared between original and new site.Translation information is copied from the original site, and then managed separately on the new site.

Frequently Asked Questions

Can I Undo The Move To A New Site URL?

You may unintentionally move your original website to a new URL. WPML provides you with two options:

  • Undo the change and revert to the original site URL
  • Mark the original site as a copy to be able to translate on both sites

Option 1: Reverting to Your Original Site URL

If you want to revert to your original site URL, log into your original website. You should see a notification giving you the option to undo the move.

banner allowing you to revert a site move
Clicking the link to revert to the original site URL

Reverting to your original domain allows you to resume translating there. However, the ability to update translations at the new URL will no longer be available.

Option 2: Marking the Original Site as a Copy

To be able to use your original site and its new location, first sign in to your original site. There, you’ll find a notification about your site moving to a new location that lets you mark your original site as a copy.

banner letting you mark original site as a copy if you moved it
Choosing to mark your original site as a copy