How to Translate Custom Liquid Section Using Translate and Adapt for the DAWN theme

Start a Business

Topic summary

Main issue: translating a Custom Liquid section in the DAWN theme using Shopify’s Translate & Adapt app.

Key guidance: A staff reply states Custom Liquid isn’t translatable out of the box. Use a “Rich text” block (supported by Translate & Adapt), or add translation keys to Liquid per Shopify’s guide (link provided).

Follow-up question: Another user needs titles and language-specific links translated in a Custom Liquid section and asks if HTML can be added to a specific Rich text.

Workaround proposed: Duplicate the section, translate content (e.g., with DeepL), and wrap each language version in Liquid conditionals using store.locale (e.g., {% if store.locale == ‘de’ %}) to show the correct language.

Technical notes:

  • Custom Liquid: a theme section where developers write Liquid/HTML; not automatically localized.
  • Translation keys: code-based keys enabling localization in Liquid.
  • store.locale: the current storefront language code used in Liquid.
  • Rich text: a translatable theme block compatible with Translate & Adapt.

Status: No definitive resolution. Suggested paths are Rich text, translation keys, or conditional Liquid. The HTML-in-Rich-text question remains open. An image link is referenced but not central.

Summarized with AI on December 29. AI used: gpt-5.
1

Hello, I would like to translate a custom liquid section on my DAWN theme using the Translate and Adapt Shopify app.

Here is an example of what I would like translated.

https://postimg.cc/87yFf89j

Thank you :slightly_smiling_face:

2

Hey @AntCrescendo , can you achieve what you need to with the ‘Rich text’ block? This is easily translatable. Custom liquid is not translatable out of the box, you need to insert translation keys and it’s not straightforward: https://www.shopify.com/uk/partners/blog/translation-keys

3

I have the some question, my web page is https://bcnsurfschool.es/ In the home page I have some liquid to go to the sections of the WebSite, I want to translate the titles and to put the links to the correct language page… Do Anybody how to translate the Custom Liquid Section? Or if is not posible how can I add a html for a an especific rich text?

Thank you very much

4

Step 1: Copy the section and translate it with Deepl.

Step 2: Insert the translation before the Liquid tag {% if store.locale == ‘de’ %}.

Step 3: Use the Liquid tag {% if store.locale == ‘de’ %} for German or corresponding tags for other languages to ensure that the section is only displayed if the corresponding language is set.

I hope this helps you!