Strings added via the Avanam theme customizer are not listed for the translation

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

Problem:

If you're experiencing issues with missing strings for translation in your custom theme, it might be due to a compatibility conflict.

Solution:

We recommend adding the following language configuration in WPML >> Settings >> Custom XML Configuration. You can create this using our Multilingual Tools plugin: https://wpml.org/documentation/support/multilingual-tools/

<wpml-config>
  <admin-texts>
    <key name="theme_mods_avanam-wooti">
      </key><key name="product_content_element_extras">
        <key name="enabled"></key>
        <key name="title"></key>
        <key name="feature_1"></key>
        <key name="feature_2"></key>
        <key name="feature_3"></key>
        <key name="feature_4"></key>
        <key name="feature_5"></key>
        <key name="feature_1_icon"></key>
        <key name="feature_2_icon"></key>
        <key name="feature_3_icon"></key>
        <key name="feature_4_icon"></key>
        <key name="feature_5_icon"></key>
        <key name="flag"></key>
      </key>
    
  </admin-texts>
</wpml-config>

After adding this configuration, please navigate to WPML >> String Translation and translate the newly registered strings into your secondary language. Finally, clear all caches and verify if the issue is resolved.

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. If the problem persists, please do not hesitate to open a new support ticket with us for further assistance 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.

This topic is split from https://wpml.org/forums/topic/string-translation-98/

Tagged: Compatibility

This topic contains 21 replies, has 0 voices.

Last updated by Bigul 8 months, 2 weeks ago.

Assisted by: Bigul.

Author	Posts
July 29, 2025 at 12:42 pm #17278831
臣新伍	Like the content of this picture, I also modified it in the custom website
July 29, 2025 at 1:24 pm #17279029
臣新伍	Could you help me solve this problem as soon as possible?
July 29, 2025 at 1:29 pm #17279035
Bigul	Hello, Welcome to the WPML support forum. I will do my best to assist you in resolving the issue. Normally, strings added via the theme options and theme customizer can be translated using WPML’s String Translation. These strings can be registered for translation by navigating to: WPML >> String Translation >> Utilities >> Not seeing strings that you are looking for? >> Admin Texts Translation, or by using a WPML language configuration file. Please refer to the attached images and the following documentation for more details: https://wpml.org/documentation/getting-started-guide/string-translation/how-to-translate-theme-options/ https://wpml.org/documentation/support/language-configuration-files/translate-strings-in-wp-options-table/ However, the strings added via the Avanam theme customizer are not appearing in Admin Texts Translation. This appears to be a compatibility issue, as the Avanam theme is currently not listed in our WPML-compatible themes directory: https://wpml.org/theme/ Therefore, we recommend reaching out to the theme author and suggesting they follow our theme compatibility guidelines: https://wpml.org/documentation/support/achieving-wpml-compatibility-for-your-themes-and-plugins/ -- Thanks! Bigul
July 29, 2025 at 2:42 pm #17279549
臣新伍	Is there no way to translate them now?
July 29, 2025 at 4:47 pm #17279873
Bigul	Hello, This can only be achieved by modifying the theme’s code, as these strings are handled directly within the theme. To make them translatable and display the translations correctly, the theme code must be adjusted to register those strings with WPML. However, it is important to note that directly editing the original theme files is not recommended. In WordPress, the best practice is to avoid altering the parent theme code because any changes will be overwritten during future theme updates. Due to this limitation, our ability to support these translations is restricted. It may be possible to achieve this through custom code in your child theme. You can use the following WPML hooks to register and display the strings for translation: https://wpml.org/wpml-hook/wpml_register_single_string/ https://wpml.org/wpml-hook/wpml_translate_single_string/ https://wpml.org/wpml-hook/wpml_current_language/ Thank you for your kind understanding and cooperation - https://wpml.org/purchase/support-policy/ -- Thanks! Bigul
July 31, 2025 at 2:47 pm #17285580
臣新伍	The theme author responded that they are compatible with wpml, and here is their response: As mentioned in your response by WPML support team, the customizer text from the Avanam theme is not appearing in WPML String Translation. However, we would like to clarify that in the Avanam theme, all translatable strings are written using the correct WPML-compatible format, such as: __( 'Guaranteed Safe And Secure Checkout', 'avanam' ) This ensures compatibility with WPML string translation. You can find this specific string 'Guaranteed Safe And Secure Checkout' and others under WPML > String Translation, as shown in the screenshot below. We have already marked and translated the string related to the product page. Screenshot - hidden link If you have cache enabled on your server side then clear cache and you may check translation or contact WPML support team with this message. Best Regards, Support Team TemplateMela
July 31, 2025 at 2:48 pm #17285583
臣新伍	hidden link
July 31, 2025 at 7:07 pm #17286480
Bigul	Hello, Thank you for the updates. I am unable to access the following link, it redirects to a login page, and the other link is showing an "Access Denied" message: hidden link So, could you please share the details as screenshots here instead? In the meantime, please try the following workaround after taking a full site backup, and check if the missing strings are now available for translation: - Switch to the Avanam parent theme. - Go to WPML >> Theme and Plugins Localization. - Scroll down to the “Scan strings in themes, plugins, and WordPress” section. - Run a scan for the Avanam theme. - Then go to WPML >> String Translation and check if the missing strings are now visible. -- Thanks! Bigul
August 1, 2025 at 2:53 am #17286927
臣新伍	Please look at this
August 1, 2025 at 4:10 am #17286986
Bigul	Hello, Thank you for the updates. The strings like __( 'Guaranteed Safe And Secure Checkout', 'avanam') are hardcoded in the theme, so scanning the theme for strings will correctly detect it and make it available for translation. However, the strings shown in the following screenshot appear to be managed dynamically via the theme options. These are typically stored in the database, most likely in the wp_options table. As a result, they should be available for translation under WPML >> String Translation >> Admin Texts Translation. hidden link hidden link If the strings are not listed there, it sounds like a compatibility issue. In that case, it may be modified in the theme code for full compatibility with WPML. Could you please verify this behavior with the theme developer and confirm how those strings are handled? Refer to the following documentation for more details. https://wpml.org/documentation/support/achieving-wpml-compatibility-for-your-themes-and-plugins/#strings-in-wp_options https://wpml.org/documentation/support/translation-for-texts-by-other-plugins-and-themes/ -- Thanks! Bigul
August 1, 2025 at 6:03 am #17287020
臣新伍	I confirmed with the theme developer again： It is not theme related issue, the translation issue. You should check with your plugin provider or you may hire developer from upwork or freelancer.
August 1, 2025 at 6:06 am #17287021
臣新伍	Could you please help me translate these few places and tell me how to translate them? Thank you very much.
August 1, 2025 at 11:28 am #17288156
Bigul	Hello, Thank you for the updates. For your kind information, this appears to be a clear compatibility conflict with the Avanam theme. As mentioned earlier, this theme is not officially compatible with WPML. With officially compatible themes or popular WordPress themes, it is possible to translate theme option strings by adding them through WPML >> String Translation >> Admin Texts Translation. However, we will do our best to assist you within our support limits. To investigate the issue further without affecting your live site, please allow me to create a copy of your site using the Duplicator plugin. This will help us debug the problem safely on our local server. -- Thanks! Bigul
August 1, 2025 at 6:22 pm #17289306
臣新伍	Thank you for helping me debug. Please tell me how to modify it after debugging.
August 4, 2025 at 2:06 pm #17293407
Bigul	Hello, Thank you for the permission. I have made a copy of the site and am currently looking into possible workarounds for this case. We will get back to you as soon as possible with further updates. Please wait. -- Thanks! Bigul