Overview

This help explains how to translate WPResidence with the Loco Translate plugin from WordPress admin.

Some text comes from the theme, some text comes from the WPResidence Core plugin, and some labels are managed directly from Theme Options, taxonomies, custom fields, menus, widgets, or Elementor templates.

Before You Start: Language, File Name, and Location

Before translating, check the WordPress site language.

Go to:

Settings > General > Site Language

WordPress loads translation files based on this language.

The translation file name must match the WordPress language code.

Example for Italian:

• it_IT.po
• it_IT.mo

If the file name is different, WordPress will not load the translation on the front end, even if the strings are translated in Loco Translate.

Theme translation files

For theme strings, the recommended location is:

wp-content/themes/wpresidence-child/languages/

Example for Italian:

• wp-content/themes/wpresidence-child/languages/it_IT.po
• wp-content/themes/wpresidence-child/languages/it_IT.mo

WPResidence Core plugin translation files

Some strings are part of the WPResidence Core plugin. For these strings, translate the core plugin file from Loco Translate.

Example for Italian:

• wpresidence-core-it_IT.po
• wpresidence-core-it_IT.mo

Where to Translate Each Type of Text

Install and Activate the Child Theme

The WPResidence Child Theme is recommended for theme translations because it helps keep translations safer during theme updates.

How to install the Child Theme

Recommended theme translation location:

wp-content/themes/wpresidence-child/languages/

Translate Theme Strings With Loco Translate

Use this section for text that comes from the WPResidence theme.

Install Loco Translate

1. Go to Plugins > Add New.
2. Search for Loco Translate.
3. Install and activate the plugin.

[https://wordpress.org/plugins/loco-translate/](https://wordpress.org/plugins/loco-translate/)

Create or edit the theme language file

1. Go to Loco Translate > Themes.
2. Select WPResidence Child Theme.
3. Create a new language or edit the existing language file.
4. Make sure the file name matches the WordPress site language, for example it_IT.po for Italian.
5. Click Sync if needed.
6. Search for the string, add the translation, and click Save.

Translate WPResidence Core Plugin Strings

Some strings are inside the WPResidence Core plugin, not in the theme language file.

1. Go to Loco Translate > Plugins.
2. Select WPResidence Core.
3. Create a new language or edit the existing language file.
4. For Italian, the files should be named wpresidence-core-it_IT.po and wpresidence-core-it_IT.mo.
5. Click Sync if needed.
6. Search for the string, add the translation, and click Save.

Texts Managed Outside Loco Translate

Some labels are not translated from .po files. They must be edited where they were added.

Theme Options labels

Some labels are managed from Theme Options, for example property page labels or search labels.

Common locations:

• Theme Options > Property Page > Listing Labels
• Theme Options > Search > Advanced Search Form
• Theme Options > General > Property Custom Fields

Property single page labels

Labels for property detail sections, such as Property Details, Address, and Features, can be edited from:

Theme Options > Property Page > Listing Labels

Property categories and taxonomy terms

Property categories, action categories, cities, areas, statuses, and features are managed directly in wp-admin.

Go to:

Properties, Agents & More > Categories

Add or edit a taxonomy term

1. Go to Properties, Agents & More > Categories.
2. Select the taxonomy type you want to manage, such as Category, Action Category, City, Area, Status, or Features.
3. Enter or edit the Title.
4. Leave Slug empty if you want WordPress to generate it automatically.
5. Click the add or update button.

Custom field labels

Property custom fields are created and managed from:

Theme Options > General > Property Custom Fields

Add the Field Label for each custom field directly in this area, in your language.

Advanced Search labels

Advanced Search labels are managed from:

Theme Options > Search > Advanced Search Form

Change the Label on Front End in your language for each field you select.

Main menu items

Menu item labels are edited from:

Appearance > Menus

Widget titles

Widget titles are edited directly from:

Appearance > Widgets

Open the widget, change the Title, and save.

Elementor and Studio template text

If the text was added inside an Elementor or Studio template, edit the template with Elementor and change the text directly there.

Update Translations After Theme or Plugin Updates

After a theme or plugin update, new strings may be added.

1. Open the child theme language file in Loco Translate and click Sync.
2. Open the WPResidence Core plugin language file in Loco Translate and click Sync.
3. Translate any new strings.
4. Click Save.

Before updating, download a backup of your custom language files if they are stored inside the theme or plugin folders.

How to update the .po translation after a theme update

Upload Translation Files With FTP or File Manager

If needed, you can upload translation files manually with FTP or hosting File Manager.

Upload both the .po and .mo files to the correct folder.

• Child theme: wp-content/themes/wpresidence-child/languages/
• Parent theme: wp-content/themes/wpresidence/languages/
• Core plugin: wp-content/plugins/wpresidence-core/languages/

Poedit Tutorial

This article focuses on Loco Translate because it is easier to manage translations directly from WordPress admin.

If you prefer to work with Poedit on your computer, use the official Poedit documentation:

Poedit Documentation

After editing translation files with Poedit, upload both the .po and .mo files to the correct theme or plugin language folder.

Translate User Role Labels

WPResidence user role labels, such as User, Agent, Agency, and Developer, can be translated with Loco Translate.

If you cannot find a role label in the theme translation file, check the WPResidence Core plugin translation file as well.

Multi-Language Websites With WPEstate Translate

Loco Translate is used to translate theme or plugin text for one site language.

If you want a website with more than one language and a language switcher, use the WPEstate Translate plugin for WPResidence.

With WPEstate Translate, you can manage translated content, translated URLs, and additional website languages.

Start by setting the main website language from:

Settings > General > Site Language

Then use WPEstate Translate to add and manage the additional languages.

WPESTATE / WPResidence Translate Plugin Overview

Translations Are Saved, but the Front End Still Shows English

If a translated string does not show on the front end, check these points:

1. Check Settings > General > Site Language.
2. Check that the language file name matches the site language, for example it_IT.po and it_IT.mo for Italian.
3. Check that the .mo file exists after saving.
4. Check both the theme language file and the WPResidence Core plugin language file.
5. Click Sync in Loco Translate after updates.
6. Check if the text is managed from Theme Options, widgets, taxonomies, custom fields, menus, or Elementor.
7. Clear all cache after saving translations.

[https://care.wpestate.org/](https://care.wpestate.org/)