← Back to Help

Troubleshooting

Solutions to common issues and frequently asked questions.

My translations aren't showing on my storefront

Translations need to be published before they appear on your live store. Check these steps:

1. Open the item in the translation editor.
2. Make sure the translations have a Published status (green badge). If they show as Translated (blue), click Publish to Shopify.
3. Verify the target language is published in your Shopify admin (Settings → Languages).
4. Check that your storefront language selector is working — visit your store and switch languages.

Content is missing after sync

If some content doesn't appear in Lingomatic after a full sync:

• Product translation limit: All products sync into Lingomatic. Basic can translate up to 100 distinct products and Growth up to 500; already-translated products remain available and can be re-translated. Upgrade only when you need to translate additional products.
• Empty fields: Lingomatic only syncs fields that contain text. Empty product descriptions or blank pages are skipped.
• Draft or archived products: Lingomatic intentionally skips them, so unfinished catalog content does not consume credits.
• Metafield namespace: Known third-party app namespaces and any namespace you exclude under Glossary → Do Not Translate are skipped.

Auto-translate isn't working

• Check your plan: Auto-translate requires a Growth or Pro plan.
• Check it's enabled: Go to Settings and verify the auto-translate toggle is on.
• Check content types: Make sure the content types you want auto-translated are checked in the settings.
• Check credits: Auto-translate pauses when you run out of credits. Check your balance on the Billing page.
• Check the monthly limit: The auto-translate monthly credit limit may have been reached. Check the progress bar in Settings.
• Non-instant content: Content types other than products and collections are checked every 15 minutes, so there's a delay before changes are detected.

Translation quality isn't good enough

• Choose Premium: On Growth and Pro, Premium adds an independent review to eligible long-form text. Pro also checks flagged sentences against the source.
• Set up your glossary: Add brand-specific terms and their correct translations to the glossary. The AI uses these automatically.
• Add do-not-translate terms: Brand names, product codes, and abbreviations that shouldn't be translated can be added to the DNT list.
• Adjust Brand Voice: Tone and custom instructions are available on every plan.
• Set the register: Choose formal or informal address separately for each supported language instead of relying on automatic inference.

I ran out of credits

When your monthly credits are used up:

• Any in-progress translations will pause.
• You can buy extra credits from the Billing page — purchased credits never expire.
• Or wait for your monthly credits to reset at the start of your next billing period.
• You can still manually edit and publish existing translations without using credits.

Glossary terms aren't being applied

• Check that the glossary term's source language matches the text exactly. If case-sensitive is enabled, capitalization must match too.
• Glossary terms are applied during translation, not retroactively. Re-translate the content to apply newly added glossary terms.
• Glossary and do-not-translate entries are unlimited on every plan.

The dashboard says "Plan limited"

The translation is valid, but Shopify's plan-specific theme-key cap has no room for it in that language. Lingomatic keeps the translation and prioritizes more visible storefront keys. Open Theme content to pin important keys or free space, then publish again. This status does not consume more credits.

Translations disappeared after a theme update

A live-theme update can remove translations registered against theme locale keys. Lingomatic listens for theme updates, waits for the update to settle, checks which published keys Shopify is missing, and republishes those keys automatically. There is nothing for you to do, and republishing costs no credits. How the repair works.

What happens to my translations if I uninstall?

They stay on your store. Published translations are stored by Shopify in its own translation layer, and uninstalling never removes them — there is no script or proxy to unpick. Our copy of your data is deleted 48 hours later, as Shopify requires, so publish anything still sitting unpublished in the editor before you go. Full details.

Third-party app content isn't showing up

Whether a third-party app's content can be translated depends on how the app stores its data:

• Metafields/Metaobjects: If the app stores translatable content in Shopify metafields or metaobjects, Lingomatic can pick it up unless its namespace is excluded. Known review and page-builder namespaces are skipped by default for safety.
• External servers: If the app stores content on its own servers (outside Shopify), it cannot be translated through Lingomatic. Contact the app developer to ask about their translation support.

Translations show "Error: Throttled" after publishing

This can happen when publishing a large number of translations at once. Shopify limits how many API requests can be made per second, and high-volume publishes can temporarily exceed this limit.

• Retry publishing: Select the failed translations and publish again. The app automatically paces requests and retries throttled calls, so a second attempt usually succeeds.
• Auto-publish handles this automatically: If you have auto-publish enabled, large batches are grouped and sent with built-in pacing to avoid hitting Shopify's limits.

Still need help?

If your issue isn't covered here:

• Growth and Pro plans: Email us at support@lingomatic.io and we'll help you out.
• Pro plan: Use live chat during business hours (Mon–Fri, 9am–6pm EET) for the fastest response.