Skip Navigation

This thread is resolved. Here is a description of the problem and solution.

Problem:
If you're experiencing issues where terms from a custom taxonomy set to 'Translatable (use translation if available or fallback to default language)' are not syncing across all translations of a post, especially in languages where the term uses its fallback (default language), this is due to the expected behavior of WPML. Only terms that have a translation in the corresponding language are synced.
Solution:
To ensure terms are correctly assigned in all languages, including those using fallback, it's important to translate each term into the respective languages. If a term is not translated, it will not sync correctly with translated posts. For a detailed explanation, you can refer to this discussion on our forum: WPML support forum.

If this solution does not apply to your case, or if it seems outdated, we highly recommend checking related known issues at https://wpml.org/known-issues/, verifying the version of the permanent fix, and confirming that you have installed the latest versions of themes and plugins. Should you need further assistance, please open a new support ticket at WPML support forum.

This is the technical support forum for WPML - the multilingual WordPress plugin.

Everyone can read, but only WPML clients can post here. WPML team is replying on the forum 6 days per week, 22 hours per day.

Tagged: 

This topic contains 10 replies, has 1 voice.

Last updated by thomasA-35 2 weeks, 6 days ago.

Assisted by: Paola Mendiburu.

Author Posts
April 3, 2025 at 11:37 am #16891666

thomasA-35

Background of the issue:
I have a custom taxonomy set to 'Translatable (use translation if available or fallback to default language)'. When I create a post and assign terms of this taxonomy, these terms should be synced across all translations of this post.

Symptoms:
Instead, only terms that have a translation in the corresponding language are synced. In languages where the term is shown with its fallback (default language), it is not correctly assigned to the post.

Questions:
Why are terms not syncing across all translations when using fallback to default language?
How can I ensure terms are correctly assigned in all languages, including those using fallback?

April 6, 2025 at 8:51 am #16900860

Bigul
WPML Supporter since 01/2013

Languages: English (English )

Timezone: Europe/Vienna (GMT+02:00)

Hello,

Welcome to the WPML support forum. Before passing this thread to my colleague, I would like to share some suggestions and possible solutions for the issues you mentioned.

Sorry for the late response because of the holidays and the high support load. It is not normal here. Thank you for your kind understanding.

This appears to be the expected behavior. Since the custom taxonomy term hasn’t been translated into the secondary language, there are no corresponding database entries for it in that language.

It should work as expected in the secondary languages when the post itself is not translated. To confirm, please try creating a new post with a new taxonomy term and check if it works correctly in the secondary languages.

As a workaround, you can duplicate or translate the taxonomy term into the secondary language.

Please refer to the following documentation for more details and let us know your feedback.

https://wpml.org/documentation/translating-your-contents/displaying-untranslated-content-on-pages-in-secondary-languages/#fallback-content

--
Thanks!

Bigul

April 7, 2025 at 9:26 am #16903151

thomasA-35

Hello Bigul,

thank you for your reply. You are right, when the post itself is not translated it works. However our use case is a translated post with a taxonomy set to translatable (with fallback). This is important, because the custom taxonomy has over 400 terms where most are the same across all languages.

I think the current behavior is not expected but a bug. As you can see in the second screenshot, WordPress displays the fallback ("Test exists only in DE") as an available term for the english translation. It is just not selected as it should be. If I manually select the term, it is correctly saved to the english translation. Hence I would expect WPML to sync it, as it does with the other terms.

Thanks!

April 9, 2025 at 11:54 am #16913171

Carlos Rojas
WPML Supporter since 03/2017

Languages: English (English ) Spanish (Español )

Timezone: Europe/Madrid (GMT+02:00)

Hello,
My name is Carlos, and I will continue working on this ticket

Could you please describe the steps you're following to translate the test content shown in the screenshots?

Looking forward to your message.

April 11, 2025 at 12:02 pm #16922579

thomasA-35

Hello Carlos,

here are the steps:

- Set up WPML with German as primary language and English as secondary language
- Create a custom taxonomy (e.g. via a plugin, see example code below)
- Set the taxonomy to 'Translatable (use translation if available or fallback to default language)' in WPML settings.
- Create two terms for this taxonomy in German.
- Translate one term to English.
- Create a German post and translate it to English.
- Assign both custom terms to the original German post.
- The term that has an English translation is correctly synced to the English post, the other one is missing (see screenshots in my first message).

Example code to register taxonomy:
add_action( 'init', 'atom_init_registers' );
function atom_init_registers() {
register_taxonomy('car_model',
array('post'),
array(
'hierarchical' => true,
'labels' => array(
'name' => 'Model'
),
'show_ui' => true,
'show_in_rest' => true,
)
);
}

April 11, 2025 at 12:04 pm #16922588

Carlos Rojas
WPML Supporter since 03/2017

Languages: English (English ) Spanish (Español )

Timezone: Europe/Madrid (GMT+02:00)

Thank you for your message.

Could you elaborate more in this step: "Create a German post and translate it to English."

My goal is to know how are you 'translating' the content 🙂

April 11, 2025 at 1:47 pm #16922996

thomasA-35

Of course, here are more precise instructions for this step:
- Click "Neuen Beitrag erstellen" ("Create new post") in German and add a test headline.
- Click "Publish".
- In the right sidebar, click on the "+" icon for the English translation.
- The translation editor opens. Translate the test headline and click "Abschließen" ("Complete")

April 14, 2025 at 2:00 pm #16929980

Paola Mendiburu
WPML Supporter since 11/2020

Languages: English (English ) Spanish (Español ) Italian (Italiano )

Timezone: Europe/Madrid (GMT+02:00)

Hi there!

This is Paola, and I'll be taking over the ticket while Carlos is on holiday.

What you’re experiencing is expected behavior. When a category is not translated, it won’t sync correctly with translated posts. My colleague has explained this in detail here:
https://wpml.org/forums/topic/taxonomies-not-synced-between-post-translations-for-taxonomies-set-to-translatable-use-translatio/#post-16900860

Let me know if you have any further questions.

April 14, 2025 at 3:27 pm #16930328

thomasA-35

Hi Paola,

thank you for your reply and for looking into this issue.

How do you determine what is expected behavior? As a user of WPML, I would expect categories to be synced correctly. "It won’t sync correctly" (as you put it) is certainly not expected behavior 😉

April 15, 2025 at 8:28 am #16932379

Paola Mendiburu
WPML Supporter since 11/2020

Languages: English (English ) Spanish (Español ) Italian (Italiano )

Timezone: Europe/Madrid (GMT+02:00)

I mean that you will need to translate the categories or duplicate them.

April 15, 2025 at 9:00 am #16932534

thomasA-35

Well this is disappointing and defeats the whole purpose of the 'Translatable (use translation if available or fallback to default language)' setting.

April 15, 2025 at 12:05 pm #16933919

Paola Mendiburu
WPML Supporter since 11/2020

Languages: English (English ) Spanish (Español ) Italian (Italiano )

Timezone: Europe/Madrid (GMT+02:00)

I would like to request temporary access (wp-admin and FTP) to your site to take a better look at the issue. You will find the needed fields for this below the comment area when you log in to leave your next reply. The information you will enter is private which means only you and I can see and have access to it.

Let me know a post where I can see that problem.

**IMPORTANT**
- Please make a backup of the site files and database before providing us access.
- If you do not see the wp-admin/FTP fields this means your post & website login details will be made PUBLIC. DO NOT post your website details unless you see the required wp-admin/FTP fields. If you do not, please ask me to enable the private box.
The private box looks like this: hidden link

April 20, 2025 at 2:01 pm #16949907

Paola Mendiburu
WPML Supporter since 11/2020

Languages: English (English ) Spanish (Español ) Italian (Italiano )

Timezone: Europe/Madrid (GMT+02:00)

Hi!

Sorry for the delay.

I have created a video where I showed you that it is expected when translating a post and you should translate or duplicate taxonomies:
hidden link

Fast bulk‑duplication of the taxonomy terms
hidden link

April 22, 2025 at 8:34 am #16953652

thomasA-35

Hi Paola,
thank you, I appreciate the time you took to create the videos. I still disagree that this is expected behavior. Clicking "synchronize taxonomies" and then having the taxonomy disappear from one translation seems like an obvious bug.
But since WPML obviously sees this differently, I will have to look at another solution for my use case.