Skip to content
GPLWP Guides

How to translate custom fields in WordPress

Multilingual Time About 30 minutes for a small set of fields 7 steps Updated 17 Sep 2026

MULTILINGUAL
The short answer

WordPress does not translate custom fields by itself. Use a multilingual plugin to decide which fields are translated, copied, or copied once, then enter each language’s values on the translated post. For ACF sites, Advanced Custom Fields Multilingual is the faster setup.

The route
  1. 01List the fields to translate
  2. 02Make the content type translatable
  3. 03Choose each field’s behaviour
  4. 04Translate labels and choices
  5. 05Translate each content item
  6. 06Test the front end
  7. 07Use the faster ACF workflow

What you need

  • A WordPress site with a multilingual plugin installed
  • Custom fields created with ACF or another custom-field system
  • Admin access
  • At least one translated post, page, or custom post type

List the fields to translate

Make a list of every custom field and decide whether it contains language-specific content or shared data. Text, textarea, WYSIWYG, button labels, and short descriptions usually need translation. Numbers, dates, product IDs, images, and tracking codes usually stay the same.

Also check that your theme, block, or page builder actually reads the field. Translating a value will not make it appear if the template never outputs that field.

Make the content type translatable

Open your multilingual plugin’s settings and make the relevant post type translatable, including any custom post type that stores the fields. Create or confirm the site languages before editing field values.

With WPML, the relevant controls are under WPML → Settings → Custom Fields Translation. Other multilingual plugins use different labels, but the same decision is required: the translated post must have its own language version.

Choose each field’s behaviour

Set text fields to Translate when each language needs different wording. Use Copy for values that must stay identical in every language. Use Copy once when the original value should be copied initially but edited separately later.

For repeater and flexible-content fields, decide whether the layout must remain identical. Copy keeps the structure synchronised; copy once allows a translation to have a different number or arrangement of rows. Set the behaviour of sub-fields as well.

Translate labels and choices

Translate the field’s label and instructions separately from the value stored on a post. If you use ACF with WPML, send the relevant field group through the translation workflow. Select, checkbox, radio, and button-group choices also need their own translations because their labels are stored with the field definition.

Do not assume that translating a post will translate the field label automatically. Field labels commonly appear in string or field-group translation screens, while field values appear with the translated post.

Translate each content item

Open a post, page, product, or custom post in the source language and create its translated version. Enter the translated values into fields marked Translate, check copied values, and save the translation. Repeat this for every content item that uses the fields.

For relationship, post-object, page-link, and taxonomy fields, check that the selected item also has a translation. A reference to the source-language object can otherwise produce the wrong title, URL, or taxonomy on the translated page.

Test the front end

Switch languages and check the rendered page, archive, search result, block, and page-builder template. If a value is missing, first check the field preference, the translated post, and the template code that reads the field. Clear page and object caches after changing translation settings.

Be careful with Copy once: later edits to the source value do not automatically update the translation. Options pages are another common failure point because global ACF settings are translated separately from posts and pages.

Use the faster ACF workflow

For an ACF-based site with many structured fields, Advanced Custom Fields Multilingual is the quicker route. It puts translation preferences alongside ACF field groups and supports translated labels, instructions, values, repeaters, flexible content, and options-page workflows.

Choose it when multilingual content includes structured fields and you want fewer separate settings screens. You still need to choose carefully between translate, copy, and copy once, then review the translated content on the front end.

The fast route

Let Advanced Custom Fields Multilingual do it

Translates custom field labels, instructions, and values; choose it when multilingual content includes structured fields.

Get Advanced Custom Fields Multilingual

Sources

  1. wpml.org /documentation/getting-started-guide/translating-custom-fiel…
  2. wpml.org /documentation/related-projects/translate-sites-built-with-a…
  3. wpml.org /documentation/translating-your-contents/acf/?utm_source=ope…
  4. wordpress.org /support/topic/acf-fields-not-working/?utm_source=openai

Questions

Can WordPress translate custom fields without a plugin?
No, WordPress does not provide a general multilingual system for custom-field values. You need a multilingual plugin or custom development to create language versions, store separate values, and select the correct value for the current language. ACF can create and display fields, but it does not by itself manage translated posts or language-specific field content.
Should every custom field be set to Translate?
No, only language-dependent content should normally be translated. Set text, WYSIWYG, and descriptive fields to Translate, but use Copy for shared numbers, images, identifiers, or settings. Use Copy once when the initial value should be inherited but editors may change it independently in each language. The wrong choice can either leave content untranslated or overwrite a translation later.
Why do translated custom fields show the original language?
The usual causes are an incorrect translation preference, editing the source post instead of its translation, or a template that reads the source object directly. Check that the post type and field are translatable, confirm that the translated post contains a value, and verify that relationship fields point to translated objects. Also clear caches after changing field settings.
How do I translate ACF options pages?
ACF options pages are translated separately from posts because they contain global settings such as contact details, header text, or footer links. In WPML, send the relevant options page through the translation dashboard, then view the front end in each language. Do not expect a post translation workflow to update options-page values automatically.
What is the fastest way to translate many ACF fields?
Use Advanced Custom Fields Multilingual with your multilingual setup, then set translation preferences from the ACF field-group workflow instead of configuring every field in separate screens. This is most useful when you have repeaters, flexible content, choices, or global options. You still need to review the field behaviour and translate each content item that has language-specific values.