WPML includes its own automatic update and install process. After you install the base WPML plugin once, you can auto-install its components and receive upgrades directly to the WordPress admin.

In this page

First time WPML installation

The first time you use WPML, you need to manually download it and install. Then, register to receive automated updates to future versions.

  1. Log in to your WPML.org account.
  2. Go to the Downloads section.
  3. Download the WPML components that you need. You will receive a ZIP file for each one of WPML’s components
    download-wpml
  4. Log into your site and in the WordPress admin, go to the Plugins page and click Add New. On the Add Plugins page click Upload Plugin, select the ZIP files that you downloaded and click Install Now.upload-plugin
    Alternatively, if you cannot upload plugins directly to WordPress:

    1. Unzip each file. A directory will be created.
    2. Upload the unzipped directories to your site’s wp-contents/plugins directory
  5. Go back to the Plugins page and enable the newly uploaded/added plugins.
  6. Follow WPML’s setup wizard to add languages to your site.

Done with the first-time installation? Remember to register WPML to receive automated updates to future versions.

Automated updates for WPML

Registering WPML to receive automatic updates (available as of WPML 3.1.7)

Registering WPML allows you to receive automatic updates, directly to the WordPress admin. Once WPML is registered, updates for WPML will appear exactly like updates for plugins that come from wordpress.org.

You need to register WPML on every site that you run it, so that you receive these updates. You can register as many sites as you need.

To register WPML, to the Plugins admin page. You will see a message asking you to register WPML.

Registration message on the plugins admin page

Registration message on the plugins admin page

* Don’t see the registration link for WPML? It means that you are using an older version that didn’t have it yet. No worries, download and install WPML manually, from your wpml.org account. You will only need to do this once. Next updates will arrive automatically.

Follow the link to buy/register and you will see WPML’s info box:

Purchase and registration options

Purchase and registration options

If you haven’t yet purchased WPML, you can do that right from within the WordPress admin. If you have a WPML account, click on the ‘Register WPML’ button.

Click to register this site

Click to register this site

Click where it says WPML account. This will take you to your account and auto-register your site. You will need to confirm that you’re adding this site. Then, you will see the key to activate WPML on the site. Copy your site-key. You can select it by double clicking on the text and copying to the clipboard (CTRL-C).

Your site key is ready. Copy it, so you can paste back in WordPress.

Your site key is ready. Copy it, so you can paste back in WordPress.

Now, return to your WordPress site and enter this site key. Click OK to complete the registration.

Paste the site-key and click OK to complete the registration.

Paste the site-key and click OK to complete the registration.

You will see a list of WPML components which are available for you to install.

Install additional WPML components

Install additional WPML components

Select the checkboxes next to the components that you need. If you also want to activate the plugins immediately, also select the checkbox ‘Activate after download’. Then, click on the ‘Download’ button. If you don’t choose the option to activate, these components will be downloaded and installed onto your WordPress site and you can activate them later from the Plugins page.

From now, you will receive updates to WPML and its components automatically to the site that you just registered.

Registration FAQ

How many sites can I register WPML on?

You can register WPML on all your sites and sites that you build for your clients.

Can others reuse my site-keys to register WPML on other websites?

No, each site-key is unique for the website you registered.

Can I stop automatic updates for any site?

You control which sites can get automatic updates from your account. You can always visit ‘My sites’ and delete site keys.

What do I need to do when the site’s URL changes?

When sites move (happens when you move from development to production) they get a new home URL. You need to register the site again to keep receiving updates for WPML. If you moved the site by copying the database, go to Plugins->Add new->Commercial and click on Unregister WPML from this site.

Unregister WPML

Unregister WPML

Go to the Downloads section.

Then, click again on Register WPML and complete the registration for the site, in its new URL.

Receiving automated updates for WPML

If you have installed WPML 3.1.7 or later and have registered it in your site, you will receive updates automatically.

Whenever a new version of WPML is available, you will see notices on the WordPress dashboard. Notices appear in the Updates and Plugins sections. Follow either to receive your updates.

WPML updates will appear like any other WordPress updates in your admin dashboard

WPML updates will appear like any other WordPress updates in your admin dashboard

  1. Click on the Plugins admin screen.
  2. Click on Updates available.
  3. Next to each of WPML’s components, click on the Update now link. Be sure to update all WPML components that you are using, starting with the main plugin.
    update-now

When you update WPML, your content (including translations) doesn’t change.

We recommend backing up your database before performing any updates. This includes WordPress, your theme and plugins. To make a database backup, you can use plugins like Duplicator and BackupBuddy. You can also take a database dump using your hosting control panel.

Updating WPML manually (for WPML before 3.1.7)

For sites that have WPML before 3.1.7, you need to update manually. After this manual update, you can register WPML and receive automated updates to future versions.

For manual updates, follow these steps:

  1. Ensure that you have a database backup for the site. You can back-up your database using plugins like Duplicator, BackupBuddy or by taking a database dump using your hosting control panel.
  2. Log in to your WPML.org account.
  3. Go to the Downloads section.
  4. Download the WPML components that you need. You will receive a ZIP file for each one of WPML’s components.download-wpml
  5. Deactivate the current WPML version that you are using. Be sure to deactivate WPML and all its components. Otherwise, the installation files may be locked and not writeable. Don’t worry, your translations are not going to be modified.
    deactivate-plugin
  6. Delete the plugin, so that you can install the new version.
    delete-pluginNote: if you cannot delete from inside WordPress, use an FTP program to delete the folders of WPML and its components from wp-content/plugins.
  7. If you have our old ‘Installer’ plugin, deactivate it and remove from the wp-content/plugins directory. The new WPML versions include the automated installer component.
  8. In the WordPress admin, go to Plugins -> new -> Upload and upload the ZIP files that you downloaded.upload-pluginAlternatively, if you cannot upload plugins directly to WordPress:
    • Unzip each file. A directory will be created.
    • Upload the unzipped directories to your site’s ‘wp-contents/plugins’ directory and overwrite the existing folders for WPML and its components.
  9. Log in to your site, go to Plugins and activate WPML and its components.

When you are done and have the current version of WPML, remember to register WPML to receive automated updates to future versions.

Updating sites using WooCommerce Multilingual

If you run a multilingual store with WPML and WooCommerce Multilingual, we recommend upgrading the plugins in the following order:

  1. Deactivate all WPML plugins.
  2. Update and activate the core WPML Multilingual CMS plugin.
  3. Update and activate other WPML plugins including WooCommerce Multilingual.
  4. Update WooCommerce.

Need an account? Buy WPML