I'm getting a breadcrumb translation error

Technical Q&A
,

Topic summary

A user encounters a breadcrumb translation error on blog posts displaying “Translation missing: en.blogs.article.blog_detail.” Despite checking the default theme content editor, no missing items were found.

Proposed solutions include:

  • Language Editor approach: Navigate to Online Store > Themes > Edit default theme content, search for blog/article-related keys (specifically blogs.article.blog_detail), and add appropriate text for any empty fields.

  • Direct locale file editing: Access Online Store > Themes > Edit code, open the Locales folder, edit en.default.json, and manually add the missing key:

    "blogs": { "article": { "blog_detail": "Blog Details" } }

  • Additional steps: Consider reverting recent theme edits or reinstalling the theme if modifications were made. Clear browser cache after changes.

Root cause: The error typically occurs when a theme references a translation key that doesn’t exist in language files, or when the key is called incorrectly in the code.

The issue remains unresolved pending user implementation of suggested fixes.

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

Hello,

I’m getting a translation error when inputting a breadcrumb into my blog posts.

The error is “Translation missing: en.blogs.article.blog_detail”

I have been into the online store - action - edit default theme content and there isn’t any items missing.

What could be causing the issue and is there a fix?

Thank you

2

Hi @MJW1994

The “Translation missing: en.blogs.article.blog_detail” error typically means your theme is trying to display a text string that doesn’t exist in your language files or theme content.

Here’s how you can fix it:

  1. Use Shopify’s Language Editor:

    • In Shopify admin, go to Online Store > Themes.

    • Click Actions > Edit default theme content on your active theme.

    • Use the search or filter to find missing translation keys or empty fields.

    • Look specifically for keys related to blog or article pages, such as blogs.article.blog_detail.

    • Add appropriate text for these missing fields and save.

  2. Check Your Theme’s Locale Files:

    • Go to Online Store > Themes > Actions > Edit code.

    • Open the Locales folder and edit the en.default.json (or your store’s language file).

    • Search for “blog_detail” or related keys. If missing, add an entry like:

    “blogs”: { “article”: { “blog_detail”: “Blog Details” } }

    • Save the file.

  3. Revert or Update Theme Files if Needed:

    • If you recently edited theme files, consider reverting to a previous version or reinstalling a fresh copy of the theme.

  4. Clear Cache and Test:

    • After saving changes, clear your browser cache or test in incognito mode to ensure the error is resolved.

This approach aligns with Shopify community solutions and official docs on fixing missing translation errors by adding the missing keys either via the language editor or directly in the locale JSON files. If you continue to have trouble, providing your theme name and how you manage translations can help narrow down the issue.

3
  • @MJW1994 *
    Please make sure you are calling it correctly
    It only happens if you call wrong translation or it does not exist
    In other cases, it should work fine
    Thanks!