Translating pure HTML block

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

Problem:
If you're experiencing issues with a pure HTML block that contains a contact form, such as

<div id="form-acm_55342"></div>

, not being detected in the Advanced Translation Editor (ATE) screen, we can help.
Solution:
We recommend using the custom XML configuration code below to inform WPML about the elements that need to be translated within your custom HTML code:


<wpml-config>
  <gutenberg-blocks>
    <gutenberg-block type="core/html" translate="1">
      <xpath type="link">//div/@id</xpath>
      <xpath type="link">*</xpath>
    </gutenberg-block>
  </gutenberg-blocks>
</wpml-config>

After adding this code to WPML > Settings > Custom XML Configuration, the form ID "form-acm_55342" should be available in ATE for translation. For more details, please visit our documentation on how to make custom Gutenberg blocks translatable.

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 do not hesitate to 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: Custom Work

This topic contains 4 replies, has 1 voice.

Last updated by Xevi Baena Ortigosa 1 week, 4 days ago.

Assisted by: Long Nguyen.

Author	Posts
March 24, 2026 at 10:09 am #17920832
Xevi Baena Ortigosa	There's a pure HTML block that loads a contact form, this one <div id="form-acm_55342"></div>, but this piece of text isn't detected in the ATE screen. I need this to be detected because I have a secondary form in the translated language, that I would insert there
March 24, 2026 at 10:28 am #17920932
Xevi Baena Ortigosa	More information below --- The page with the problem is this one: - Original: hidden link - Translation: hidden link The element I have problems with is here: hidden link As you can see is a subscription form in red color (like Mailchimp, but from another company, Acumbamail) that loads through a <div> tag. I created a translation of that subscription form for the translated page inside Acumbamail, with another form ID, so I would like to insert it there. I've tried to edit the translation manually and WPML always reminds me not to do that and I ignore the pop-up. However, the problem is that when I edit that page I have to go back and forward with ATE and manual editing the translation to always have the translated form in the translated page and after one year like this it has become a bit tiring. If ATE would be able to detect that HTML block inside the ATE screen that would be it and I would save a lot of time
March 25, 2026 at 8:24 am #17924841
Ivan Kozakov Supporter	Hello, My name is Ivan, I'm a developer from the ATE team. Thank you for the detailed explanation. We are currently investigating this issue on our side and looking into possible solutions. We will get back to you shortly with an update.
March 27, 2026 at 8:34 am #17931131
Long Nguyen WPML Supporter since 02/2022 Languages: English (English ) Vietnamese (Vietnamese ) Timezone: Asia/Ho_Chi_Minh (GMT+07:00)	Hi Xevi, I'm Long from the WPML Development team, I'm happy to help you with this issue. I suggest you use the custom XML configuration code below to tell WPML what should be translated in the custom HTML code <wpml-config> <gutenberg-blocks> <gutenberg-block type="core/html" translate="1"> <xpath type="link">//div/@id</xpath> <xpath type="link">*</xpath> </gutenberg-block> </gutenberg-blocks> </wpml-config> then the form ID "form-acm_55342" is available in ATE for translation. You can add the code to WPML > Settings > Custom XML Configuration, and get more information in the document link https://wpml.org/documentation/support/language-configuration-files/make-custom-gutenberg-blocks-translatable/#registering-gutenberg Looking forward to your reply. Thanks
March 27, 2026 at 9:40 am #17931337
Xevi Baena Ortigosa	Just leaving a message to confirm that the solution worked out. Thanks Long!