Articles on: Frequently Asked Question

FAQ: Too Many Translation Keys and how to resolved it

If you're encountering "Too many translation keys" when copying customizations to the new updated theme and are unable to edit or save translations through Transcy, it likely means you have exceeded the limit of translation entries allowed for your store's languages.

Shopify enforces a hard limit on the number of translation keys allowed per theme. When your theme exceeds this limit:

Translation apps like Transcy become unable to save new translations
Existing translations may stop displaying properly

This is not a Transcy issue, it's a Shopify platform limitation in how themes handle translation files. Themes with extensive customization options or multiple sections often hit this threshold.

Solution

Here are some solutions you can forward to your theme developer to resolve these issues:

Reducing the number of translation keys:

Simplify your theme by removing or consolidating text elements that require translation.

Avoid duplicating similar text blocks across different sections of your theme.

Use plain text where possible instead of complex HTML or Liquid code in text blocks, as these can generate more translation keys.

Extending the number of translation keys:

Add new text elements or sections that require translation to provide more detailed localization.

We truly understand that this situation may cause some frustration, but it involves theme code and translation management beyond the app's capabilities, such as Transcy. Please contact with the theme developer or Shopify Support to request theme optimization that reduces the number of unique translation keys. This is the only reliable way to resolve this issue.

Updated on: 07/11/2025

Was this article helpful?

Thank you!