Shopify App Embed Default Translation Issue in Liquid Schema

Shopify Apps

Topic summary

A developer is experiencing a translation error when setting default values in a Shopify app embed’s liquid schema. The default translation key t:app_header_default displays correctly in the Shopify editor’s input field but throws a “missing translation” error when rendering in HTML, stating the key isn’t present in the “en” locale files.

Technical Details:

  • The issue occurs in blocks/app-embed.liquid with a text input setting
  • Default value uses translation syntax: "default": "t:app_header_default"
  • Error message: missing translation: "t:app_header_default" is not present in any of the ["en"] schema locale files

Current Status:
The developer questions whether this is a Shopify translation system bug or missing localization setup. One response suggests the issue relates to using a free theme with advanced customizations, though this doesn’t directly address the translation configuration problem. The discussion remains unresolved with no clear solution provided.

Summarized with AI on October 29. AI used: claude-sonnet-4-5-20250929.
1

I’m encountering an issue while setting a default translation for a text input in my Shopify app extension’s settings. The default value appears correctly inside the Shopify editor input field, but when I try to render it inside the HTML, I get the following error:

missing translation: "t:app_header_default" is not present in any of the ["en"] schema locale files

However, the default value is still visible inside the input field.

Ekran Resmi 2025-04-06 09.45.33.png
Ekran Resmi 2025-04-06 09.45.33.png592×1328 38.9 KB

Here’s my blocks/app-embed.liquid code:


  {{ block.settings.app_btn_header }}

{% schema %}
{
  "name": "App Embed",
  "target": "body",
  "enabled_on": { "templates": ["*"] },
  "settings": [{ "type": "text", "id": "app_btn_header", "label": "t:app_header", "default": "t:app_header_default" }]
}
{% endschema %}

Is this a bug in Shopify’s translation system, or am I missing a required setup for localization?

Ekran Resmi 2025-04-06 09.53.31.png
Ekran Resmi 2025-04-06 09.53.31.png1224×130 20.2 KB

2

you are only using a free theme and you wanted to make an extraordinary changes and effect on the apps
it will keep bringing error 404