Skip to content Skip to sidebar

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

Problem:
You are using WPML with Divi and the Diviflash plugin, specifically the FAQ Module (difl_faq / difl_faqitem), and you want the FAQ titles to be recognized by the WPML Translation Editor. Although the FAQ answers are detected, the FAQ titles are not showing up for translation.
Solution:
First, ensure that the DiviFlash plugin author is aware that for compatibility with WPML, they should follow the documentation on registering page builder content for translation, which can be found here: https://wpml.org/documentation/support/language-configuration-files/register-page-builder-content-for-translation/.
Next, update your custom XML configuration in WPML > Settings > Custom XML Configuration with the following code:

<wpml-config>
    <shortcodes>
        <shortcode>
            <tag label="FAQ Item">difl_faqitem</tag>
            <attributes>
                <attribute label="FAQ Question" encoding="allow_html_tags">question</attribute>                
                <attribute label="FAQ Answer" encoding="allow_html_tags">content</attribute>                
                <attribute label="Question Image Alt Text">close_que_img_alt_txt</attribute>
                <attribute label="Open Question Image Alt Text">open_que_img_alt_txt</attribute>
                <attribute label="Answer Image Alt Text">answer_image_alt_text</attribute>                
                <attribute label="Button Text">button_text</attribute>                
                <attribute label="Button URL" type="link">button_url</attribute>                
                <attribute label="Question Image" type="media-url">close_question_image</attribute>
                <attribute label="Open Question Image" type="media-url">open_question_image</attribute>
                <attribute label="Answer Image" type="media-url">answer_image</attribute>                
                <attribute label="Admin Label">admin_label</attribute>
            </attributes>
        </shortcode>
    </shortcodes>
</wpml-config>

After saving this configuration, edit the FAQ Item on the original page, save the page, and open the translation editor. You should now see the strings of the module inside the translation editor.
If this solution does not resolve your issue, it may be due to the plugin author's responsibility to ensure compatibility with WPML. In such cases, we 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. If the problem persists, please open a new support ticket at https://wpml.org/forums/forum/english-support/.

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 5 replies, has 0 voices.

Last updated by stefanoM-53 1 week ago.

Assisted by: Andreas W..

Author Posts
October 24, 2025 at 4:41 pm #17517607

stefanoM-53

Background of the issue:
I am trying to use WPML (Pro) with Divi and the Diviflash plugin, specifically the FAQ Module (difl_faq / difl_faqitem). I want the FAQ titles (questions) to be recognized by the WPML Translation Editor. I have already tried defining the modules in the Custom XML Configuration. The issue can be seen on this page: hidden link

Here is the XML configuration that I set up in WPML/Settings

<wpml-config>
<admin-texts>
<key name="mailto_link">mailto:</key>
<key name="tel_link">tel:</key>
</admin-texts>

<shortcodes>
<shortcode>
<tag>difl_faqitem</tag>
<attributes>
<attribute>faq_question_title</attribute>
<attribute>faq_answer</attribute>
</attributes>
</shortcode>
</shortcodes>

<custom-fields>
<custom-field action="translate">faq_question_title</custom-field>
<custom-field action="translate">faq_answer</custom-field>
</custom-fields>

</wpml-config>

Symptoms:
The FAQ answers are correctly detected by the WPML Translation Editor, but the FAQ titles (<h3 class="faq_question_title">…</h3>) are missing.

Questions:
Why are the FAQ titles not showing up for translation in the WPML Translation Editor?
How can I ensure that the FAQ titles are recognized by the WPML Translation Editor?

October 26, 2025 at 12:45 am #17518993

Andreas W.
WPML Supporter since 12/2018

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

Timezone: America/Lima (GMT-05:00)

Hello,

Likely, the Custom XML Configuration is not yet correct.

You can use the following plugin to obtain the correct config:
https://wpml.org/documentation/support/multilingual-tools/

Note that you will only need a config for "shortcode" - not for "custom fields" or "admin texts".

A more detailed guide can be found here:
https://wpml.org/documentation/support/language-configuration-files/register-page-builder-content-for-translation/

If this still does not solve the issue for you, please install the "DiviFlash" plugin on the following test site and leave me a comment so that I can take a closer look at it.

One-Click-Login:
hidden link

Best regards
Andreas

October 29, 2025 at 8:07 am #17528086

stefanoM-53

Hi Andreas,

thanks a lot for your reply.

I installed the plugin but I'm not sure what to do now.

Maybe can you help me?

Best regards,
Stefano

October 29, 2025 at 10:35 pm #17530909

Andreas W.
WPML Supporter since 12/2018

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

Timezone: America/Lima (GMT-05:00)

Hi Stefano!

The plugin adds a section called "WPML: Custom XML Configuration" at the bottom of the WordPress Editor, which will include a custom XML configuration for the page builder widgets found inside the content.

It further returns the raw post content data, which can assist in creating such a config yourself.

This config can then be saved at WPML > Settings > Custom XML Configuration (tab).

After saving the config, you will need to edit the original content, save the page, and then open the translation editor, where you should now see all translatable texts.

Note that it is not recommended to install the plugin on a production site. Do you have a staging site ready where I would be able to work?

---

At this point, I am not sure if this plugin actually also handles automatic config creation for Divi - it would be ideal if you could install the latest version of the "DiviFlash" plugin on my sandbox, and I will assist you with creating a config.

One-Click-Login:
hidden link

Make sure to leave me a comment once the plugin has been installed. If the usage of the plugin requires a registration key and you do not have such a key available, we do not expect you to purchase a key for this purpose.

In such a case, I can offer to try to create the config directly on your site, or a staging site that you can provide, or it would be better to report the issue to the plugin author directly.

Best regards
Andreas

November 2, 2025 at 11:32 am #17538114

stefanoM-53

Hi Andreas,

sorry for the late reply but I don't get any email when you answer the ticket 🙂

Anyway I installed Diviflash on your staging site and activate the license.

Looking forward to hear from you!

Best regards,
Stefano

November 4, 2025 at 11:48 pm #17547916

Andreas W.
WPML Supporter since 12/2018

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

Timezone: America/Lima (GMT-05:00)

It appears that I am sadly not able to use the DiviFlash plugin without having a plugin key.

Anyhow, I was able to take a closer look at its code, and this plugin seems to come with 86 modules for Divi.

The author should be informed that if he wants the plugin to be compatible with WPML, he should follow this documentation:
https://wpml.org/documentation/support/language-configuration-files/register-page-builder-content-for-translation/

Please try the following custom XML configuration for the FAQ Item:

<wpml-config>
    <shortcodes>
        <shortcode>
            <tag label="FAQ Item">difl_faqitem</tag>
            <attributes>
                <attribute label="FAQ Question" encoding="allow_html_tags">question</attribute>                
                <attribute label="FAQ Answer" encoding="allow_html_tags">content</attribute>                
                <attribute label="Question Image Alt Text">close_que_img_alt_txt</attribute>
                <attribute label="Open Question Image Alt Text">open_que_img_alt_txt</attribute>
                <attribute label="Answer Image Alt Text">answer_image_alt_text</attribute>                
                <attribute label="Button Text">button_text</attribute>                
                <attribute label="Button URL" type="link">button_url</attribute>                
                <attribute label="Question Image" type="media-url">close_question_image</attribute>
                <attribute label="Open Question Image" type="media-url">open_question_image</attribute>
                <attribute label="Answer Image" type="media-url">answer_image</attribute>                
                <attribute label="Admin Label">admin_label</attribute>
            </attributes>
        </shortcode>
    </shortcodes>
</wpml-config>

This config includes support for:
Text content with HTML support:
- question
- content (answer)

Image URLs marked as type="media-url":
- close_question_image
- open_question_image
- answer_image

Alt text fields:
- close_que_img_alt_txt
- open_que_img_alt_txt
- answer_image_alt_text

Button fields:
- button_text
- button_url (marked as type="link") --> internal links will be auto-adjusted

Admin field:
- admin_label

Save this config at WPML > Settings > Custom XML Configuration. Then edit the FAQ Item on the original page, save the page, and open the translation editor.

You should now see the strings of the module inside the translation editor.

If this does not work out as expected, please kindly note that it is the responsibility of the plugin author to provide a config for each module to be compatible with the WPML Translation Editor. Our support does not create such configs for third-party plugins.

November 5, 2025 at 10:31 am #17549208

stefanoM-53

Hi Andreas,

thank you so much for your help!

It worked smoothly 🙂

Best regards,
Stefano