Skip Navigation
Home » WPML Documentation » Related Projects » Advanced Custom Fields (ACF) Multilingual – Translate All Fields with WPML » Translating ACF Blocks With WPML

Translating ACF Blocks With WPML

Kathy Banach
Updated
February 13, 2025

Learn how to translate ACF Blocks with WPML, and display the same or different fields across languages.

Required Plugins

To translate ACF blocks, install and activate the following plugins:

  • ACF
  • WPML
  • WPML String Translation
  • ACFML

How to Translate ACF Blocks

WPML gives you two options when translating ACF Blocks:

Same Fields Across Languages

With this option, your ACF blocks have the same content and layout as your original language.

Same fields across languages (English)
ACF blocks in English
Same fields across languages (Spanish)
ACF blocks in Spanish

To translate ACF blocks so that they appear the same across languages:

  1. Go to WPML → Translation Management
  2. Select the content with your ACF blocks.
  3. Choose a translation method and send for translation.

When naming your fields, avoid repeating the same Field Name. Using the same Field Name for multiple fields may prevent some from appearing in the translation editor.

Different Fields Across Languages

With this option, your ACF Blocks display different fields and layout in each language.

Different fields across languages (English)
ACF blocks in English
Different fields across languages (Spanish)
ACF blocks in Spanish

To translate ACF blocks so that they appear different across languages:

  1. Edit the page with your ACF blocks.
  2. On the right sidebar, expand the Language section and click WordPress Editor. A popup will appear. Leave as This page and click Apply.
Switching to WordPress Editor (1)
Switching to WordPress Editor
  1. Next, click the plus icon for the language you want to translate your post into. A blank page will open.
  2. Enter the contents and ACF Blocks you want to display in this language. Publish when done.