How to edit and translate system pages

Important notes!

  • This article refers to the system, subscription, and membership templates introduced in Version 35. If you are on an older version, refer to the legacy guide instead.

  • This method works only if you are using a child theme, as the original parent theme is read-only. Automated translations are included for the following languages: da, de, en, es, fi, fr, fr-be, hu, it, ja, nl, nl-be, no, pl, pt, ro, sv. If your language is not listed, let us know and we will include it in a future update.

  • This method translates your system pages into specific languages, but HubSpot system pages cannot be created in multiple language versions unlike regular pages. They default to your website's primary language. You can learn more in the HubSpot Knowledge Base.

HubSpot system pages cannot be edited through the page editor and can only be modified via code. However, Act3 makes it possible to translate the text labels used in these templates without touching the HTML. You can find all available translations in the original theme folder here:

@marketplace/Neambo/Act3/templates/_locales

To change the text for a specific language, go to that language folder, right-click the messages.json file, and clone it to your child theme:

The new editable file will be in your child theme at the same location. To modify a label, find it in the file and change only the message between the quotes:

Some text labels from system modules may not be editable, as HubSpot translates them automatically. If a label is not in the messages.json file, it is likely one of those.

To add a new language, follow the same steps but rename the language folder with the appropriate language code. Here are the supported language codes: af, ar_eg, bg, bn, ca_es, cs, da, de, el, en, en_gb, es, es_mx, et, fi, fr, fr_ca, he_il, hi, hr, hu, id, it, ja, ko, lt, ms, nl, no, pl, pt, pt_pt, ro, ru, sk, sl, sv, th, tl, tr, uk, vi, zh_cn, zh_hk, zh_tw.