Skip to content Skip to sidebar
Home » WPML Documentation » Related Projects » Advanced Custom Fields (ACF) Multilingual – Translate All Fields with WPML » Using the Expert Translation Option on Sites Built with ACF and WPML

Using the Expert Translation Option on Sites Built with ACF and WPML

Kathy Banach
Updated
October 3, 2025

Expert mode lets you decide how to translate ACF custom fields, giving you more control over how your content appears in different languages.

Let’s say your Contact page uses ACF’s Email and Link fields. Instead of using the same email address and URLs in every language, you want each language version to have its own content.

Contact page built with custom fields in the default language

Contact page in the secondary language with translated Email and Link custom fields

In cases like this, you can use ACFML’s Expert mode. It lets you decide how to handle each custom field in your translations.

If you set up your site with ACF and WPML before ACFML 2.0 was released, your existing field groups will use Expert mode. This lets you keep your current multilingual setup and translations as they are.

1. Decide How to Translate Each Custom Field in Your Field Group

With WPML, you can choose between four translation preferences for each custom field in your field group:

  • Translate
  • Copy 
  • Copy Once
  • Don’t translate 

You can set them either in the Custom Fields Translation section in WPML → Settings or the field group edit screen in ACF → Field Groups.

To learn more, check out our guide to translation preferences for ACF custom fields.

2. Translate the Custom Fields

Once you set your translation preferences, WPML offers two ways to translate your custom fields.

How to Translate Custom Fields for Consistent Values and Layout Across Languages

To display the same content across all languages:

  1. Start by checking your field names. To appear in the Advanced Translation Editor:
  • Each custom field must have a unique name. If the same Field Name is used more than once, some values may not appear in the Advanced Translation Editor.
  • Field names can’t begin with an underscore (_). These are treated as system fields, so their values won’t be available for translation.
  1. Send the post or page that has the custom fields assigned to it for translation:
  • Go to WPML → Translation Dashboard.
  • Select the post or page that has the custom fields assigned to it.
Selecting the post with assigned custom fields in the Translation Dashboard
  • Choose a translation method and click to Translate.

How to Translate Custom Fields for Different Values and Layout Across Languages

To use different custom field values, have a different number of fields, or have a different field order across languages:

  1. Edit the post or page with the custom fields assigned to it.
  2. In the Language box, select the WordPress Editor. Confirm that you want to use the editor to translate this post content.
Selecting to translate the page with the WordPress Editor
  1. Click the plus icon next to the secondary language you want to translate your page into.
  2. Manually enter your page title, description, and replace the original custom field content with your translations. Then, click Publish.
Adding the secondary language field values in the WordPress editor

If you’re using Repeater or Flexible Content fields, and want to have a different field order in your secondary language:

  1. Edit the post in your default language. 
  2. In the ACFML Synchronise Translations section at the bottom of the page, uncheck the option to keep repeater and flexible sub-fields in the same order.
  3. Update the page.
Disabling the option to keep the field order in sync across languages