{"id":113,"date":"2026-09-25T06:56:39","date_gmt":"2026-09-25T06:56:39","guid":{"rendered":"https:\/\/docs.latw.ai\/uncategorized\/translating-custom-elementor-widgets\/"},"modified":"2026-09-25T06:56:39","modified_gmt":"2026-09-25T06:56:39","slug":"translating-custom-elementor-widgets","status":"publish","type":"post","link":"https:\/\/docs.latw.ai\/pl\/latw-multilingual\/translating-custom-elementor-widgets\/","title":{"rendered":"Translating Custom Elementor Widgets"},"content":{"rendered":"

Available in PRO<\/strong> (version 2.4.0 and later).<\/em><\/p>\n

When AI translates an Elementor page, it does not send the whole page layout to the translation
\nengine. It sends only the texts it knows are texts: a heading’s title, a button’s label, a tab’s
\ncontent. For that it keeps a list of widgets and of the settings in each widget that hold text.
\nThe list covers the widgets of Elementor, Elementor Pro and PowerPack for Elementor.<\/p>\n

A widget that is not on the list is skipped<\/strong>. That is the case for widgets your theme brings
\nwith it, and for widgets from add-on packs the plugin does not know. The rest of the page is
\ntranslated, but the texts inside those widgets stay in the original language. No error is shown,
\nbecause nothing failed: the plugin simply did not know those settings were text.<\/p>\n

The Elementor Widgets<\/strong> screen lets you close that gap yourself, without code: scan the site,
\nsee which widgets are not translated, and tick the settings that hold text.<\/p>\n

This page is about widgets an add-on built from scratch<\/strong> for Elementor. A widget whose type
\nstarts with wp-widget-<\/code> is a different thing – it is your theme’s own WordPress<\/strong> widget
\n(Search, Categories, Recent Posts, Tag Cloud, or a theme’s own widget class), only wrapped so it
\ncan be dragged onto an Elementor page. Its text is not stored in Elementor’s settings at all – see
\nTranslating Widgets<\/em> for how that text is handled instead. That is also why a wp-widget-*<\/code> entry
\nalmost always lands under No text found<\/strong> on this screen: there is nothing in _elementor_data<\/code>
\nfor it to find.<\/p>\n

When you need this<\/h2>\n
    \n
  • A section of an otherwise translated page is still in the original language, and that section
    \nis a widget from your theme or from an add-on.<\/li>\n
  • You installed a new Elementor add-on and want its widgets translated too.<\/li>\n<\/ul>\n

    If a whole Elementor page is not translated, this screen is not the cause – check the page in the
    \nLATW Translations<\/strong> box first.<\/p>\n

    Scanning the site<\/h2>\n

    Go to LATW Multilingual \u2192 Elementor Widgets<\/strong> and click Scan site<\/strong>. The plugin reads every
    \nElementor page, post and template (including headers, footers and popups built with the Theme
    \nBuilder) and lists each widget it does not know. The scan reads your content only; it does not
    \nchange anything and does not contact the translation engine, so it costs nothing.<\/p>\n

    The results are grouped:<\/p>\n

      \n
    • Not translated yet<\/strong> – widgets that hold text and are skipped today. This is where you work.<\/li>\n
    • Translated with your settings<\/strong> – widgets you already set up.<\/li>\n
    • Configured in code<\/strong> – widgets your theme or a plugin already set up for translation. Nothing
      \nto do here.<\/li>\n
    • No text found<\/strong> – widgets with no text stored in your pages (images, spacers, icons\u2026).<\/li>\n<\/ul>\n

      Run the scan again after you add new widgets to your pages or install a new add-on.<\/p>\n

      Each group, and each widget card, can be folded by clicking its heading; Expand all<\/strong> and
      \nCollapse all<\/strong> fold or unfold everything at once. Widgets you already set up start folded. The
      \nscreen remembers what you folded, in this browser.<\/p>\n

      Working on one page<\/h3>\n

      To see only the widgets used on a particular page, pick it in Show widgets on<\/strong>. The list holds
      \nevery page, post and template the scan found a listed widget on, with the number of widgets on
      \neach. Groups with nothing on that page are hidden, and each group’s count shows how many of its
      \nwidgets are on the page. Choose All pages<\/strong> to see everything again.<\/p>\n

      Choosing what to translate<\/h2>\n

      Each widget is shown as a card: its name, how many times it is used, links to a few pages that use
      \nit, and a table of its settings with an example value taken from your pages.<\/p>\n

        \n
      • Text fields are ticked for you<\/strong> when the widget is active on your site – the plugin can see
        \nwhich settings the widget declares as text (single-line text, multi-line text, rich text).<\/li>\n
      • Settings that are not text are greyed out<\/strong> and cannot be ticked: selects, switches, colors,
        \nicons, numbers. A setting that picks a contact form, a menu or a template is one of these – it
        \nstores an ID, and translating it would break the link to the form.<\/li>\n
      • Link fields are offered but not ticked.<\/strong> Tick one only when the link should lead to a
        \ndifferent address in each language. Links to pages on your own site are usually handled already
        \nby the Internal links in content<\/strong> setting.<\/li>\n
      • Settings of an inactive widget.<\/strong> If the add-on that provides the widget is switched off, the
        \nplugin cannot see its settings. It then lists only the values stored in your pages that look like
        \ntext, and ticks none of them.<\/li>\n<\/ul>\n

        Always look at the example values before you save. A text field can still hold something that must
        \nnot be translated – an HTML ID, a CSS class, a shortcode. Leave those unticked.<\/p>\n

        Click Save<\/strong>. From then on, every AI translation of a page that uses this widget includes the
        \nticked settings. To stop, click Stop translating<\/strong> on the card. Translations that already exist
        \nstay as they are.<\/p>\n

        Updating pages that are already translated<\/h2>\n

        Saving a widget’s settings does not change your pages, so pages you translated earlier still count
        \nas up to date and will not be translated again on their own.<\/p>\n

        To bring them up to date, translate them again the usual way – from the Posts<\/strong> screen or the
        \nLATW Translations<\/strong> box of each page. The widget’s card lists how many pages use it, and picking a
        \npage in Show widgets on<\/strong> shows which widgets it holds, so you can see which pages are affected.<\/p>\n

        Translating a page again sends the whole page<\/strong> to the translation engine, not just the widget,
        \nand is billed like any other translation.<\/p>\n

        If you change a widget’s settings while one of its pages is being translated, that translation
        \nfails with the message that the Elementor content or widget settings changed. Nothing is written
        \nto the page. Translate it again.<\/p>\n

        What this does not do<\/h2>\n
          \n
        • Texts left at the widget’s default.<\/strong> Elementor stores a setting in the page only when you
          \nchange it. A button label you never touched is not in the page at all – the widget prints its
          \nbuilt-in text, which comes from the theme or add-on. Translate those under
          \nLATW Multilingual \u2192 Themes & Plugins<\/strong>.<\/li>\n
        • Content outside the widget.<\/strong> A widget that shows a contact form, a menu or a post only points
          \nto it. The form, menu or post is translated on its own – for Contact Form 7 see
          \nTranslating Contact Form 7 Forms<\/em>.<\/li>\n
        • Lists inside lists.<\/strong> Repeater items (a list of tabs, slides, features) are supported. A list
          \nnested inside a repeater item is not.<\/li>\n
        • Elementor 4 (Atomic) widgets from other add-ons.<\/strong> They store text in a different format and
          \nare not offered on this screen.<\/li>\n
        • Built-in widgets.<\/strong> Elementor, Elementor Pro and PowerPack widgets are already covered and
          \ncannot be changed here.<\/li>\n<\/ul>\n

          Developer reference<\/h2>\n

          The screen stores its choices in the latwmp_elementor_widgets<\/code> option. A theme or plugin can
          \ndeclare its widgets in code instead, through the latwmp_elementor_widgets_to_translate<\/code> filter –
          \nfor example from a child theme’s functions.php<\/code>:<\/p>\n

          add_filter( 'latwmp_elementor_widgets_to_translate', function ( $widgets ) {\n    $widgets['tj-form'] = array(\n        'match'  => array( 'widgetType' => 'tj-form' ),\n        \/\/ Each entry is a path under the widget's settings.\n        'fields' => array(\n            array( 'tj_title' ),\n            array( 'tj_subtitle' ),\n            array( 'button_link', 'url' ), \/\/ $settings['button_link']['url']\n        ),\n        \/\/ Repeaters: one group per repeater control ('items' => one group is also accepted).\n        'items_groups' => array(\n            array(\n                'items_field' => 'features',\n                'fields'      => array( array( 'feature_text' ) ),\n            ),\n        ),\n    );\n    return $widgets;\n} );<\/code><\/pre>\n
            \n
          • The filter receives the built-in list merged with the choices from the Elementor Widgets<\/strong>
            \nscreen, so code has the last word.<\/li>\n
          • A widget declared in code is shown under Configured in code<\/strong> and cannot be edited on the
            \nscreen.<\/li>\n
          • Only list settings that hold text a visitor reads. Never list a setting that stores an ID,
            \nbecause the translation would replace it.<\/li>\n
          • Settings driven by an Elementor dynamic tag are handled automatically: only the tag’s
            \nbefore<\/em>, after<\/em> and fallback<\/em> texts are translated.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
            Available in PRO (version 2.4.0 and later). When AI translates an Elementor page, it does not send the whole page layout to the translation engine. It\u2026<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_latwm_translated_slug":"","footnotes":""},"categories":[4],"tags":[],"class_list":["post-113","post","type-post","status-publish","format-standard","hentry","category-latw-multilingual"],"_links":{"self":[{"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/posts\/113","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/comments?post=113"}],"version-history":[{"count":2,"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/posts\/113\/revisions"}],"predecessor-version":[{"id":121,"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/posts\/113\/revisions\/121"}],"wp:attachment":[{"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/media?parent=113"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/categories?post=113"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/tags?post=113"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}