Skip to main content

How To Translate Or Localize UsersWP

2 min read Last Updated: February 18, 2025
Facebook Twitter Linkedin Email Copy Link

UsersWP, by default, comes in English. (en_US)

Our users fully translated UsersWP into
several languages. If yours is incomplete or you want to edit a language, you can by following the steps in this document.

There are 2 options, creating a translation file or using an existing translation file.

  1. Create a translation file.

    2. Download and install
    POEdit. Launch it to open this file: 

    userswp/languages/userswp-en_US.po<br>

    Add your translations and once you finish, click File > Compile to MO…

    Change the file name to reflect your Locale (the Locale is a unique code for each language). For example, if your translation is to Italian, the locale is it_IT. 

    The file name should be: 

    userswp-it_IT.mo<br>

    Here you can find the full list of
    Locale codes.

    Inside the wp-content folder, create the folder /languages/

    Inside the languages folder, create the folder /plugins/

    Transfer the .mo file via FTP into the newly created folder:

    The complete path should look like this: 

    wp-content/languages/plugins/userswp-it_IT.mo<br>
  2. Using an existing translation file

    3. Download the desired language file from the UsersWP GlotPress page.

    You can download the file as .po file and modify it following point 1 of this doc or download it directly as .mo file, skip editing with POEdit / compiling the mo file, and follow the steps from
    here.

    If you save the translation file in the wp-content/plugins/userswp/languages/ folder, you will lose your translation with each plugin update.

  3. Change WordPress language

    4. From your WordPress dashboard go to Settings > General > Site Language. Change it to your language. WordPress and UsersWP will start using the translation files for your language. 

Translating Add-ons

to translate the add-ons the procedure is identical. Only the location of the translation files changes:

They can be downloaded from our website and not from wordpress.org. 

The URL is
https://userswp.io/translate/projects/.

Once you are ready to
load your translation file, the path for example for the Location Manager should look like this:

/wp-content/languages/plugins/userswp-en_US.mo

Let’s take another example. For the Advanced search add-on the path should look like this:

/wp-content/languages/plugins/uwp-search-en_US.mo

Updating Translations

Sometimes a new release comes out with new features and in some cases, these new features require new text strings.

When this happens, you’ll need to merge your translated PO file with the new language file provided with the update.

To do so, you need to have both files on your desktop. For example: 

userswp-it_IT.po (your translated PO file)
&
userswp-en_US.po (the new translation file shipped with the plugin update)

Open the first file (userswp-it_IT.po) with POEdit 

From the PoEdit menu, click
Catalogue and then Update from POT file…

Browse to the new PO file (userswp-en_US.po) and press the open button.
That will merge the new language strings with your translated file. Make any changes as required, save and upload the new MO file with updated translation in the wp-content/languages/plugins folder.    

On this page