Troubleshooting

Common issues and their solutions.

Translation Service Issues

”Translation service error”

Symptoms: Translation fails with service error

Solutions:

1. Check your character usage hasn’t exceeded plan limits
2. Verify your subscription is active
3. Check LinguaFlow status page for service updates
4. Try again in a few moments
5. Contact support if issue persists

”Character limit exceeded”

Symptoms: Translation fails with character limit error

Solutions:

1. Check usage in LinguaFlow dashboard
2. Upgrade to a higher plan
3. Wait for monthly reset
4. Process in smaller batches
5. Contact support for immediate limit increase

”Translation request timeout”

Symptoms: Translations hang or timeout

Solutions:

1. Check internet connection
2. Reduce batch size
3. Increase timeout in Settings → Advanced
4. Try translating one item to test
5. Check provider status page

Sync Issues

”No content found to sync”

Symptoms: Sync completes but finds 0 items

Solutions:

1. Verify content exists in Shopify store
2. Check LinguaFlow has required permissions
3. Try syncing specific resource type
4. Refresh page and retry
5. Check Shopify API status

”Sync stuck or hanging”

Symptoms: Sync operation doesn’t complete

Solutions:

1. Refresh browser page
2. Check Operations page for errors
3. Cancel operation and retry
4. Sync in smaller batches
5. Check browser console for errors

”Partial sync - some items missing”

Symptoms: Sync completes but items are missing

Solutions:

1. Check for items in draft status
2. Verify items are published
3. Check item access permissions
4. Review sync filters/settings
5. Try syncing missing items individually

Registration Issues

”Registration failed”

Symptoms: Cannot publish translations to store

Common Causes:

• Target locale not active
• Content validation errors
• API permissions issues
• Shopify API rate limits

Solutions:

1. Verify translation is complete
2. Check target locale exists in Markets
3. Ensure locale is not archived
4. Check for content validation errors
5. Try registering one item
6. Review error message details
7. Wait and retry if rate limited

”Translations registered but not visible”

Symptoms: Registration succeeds but translations don’t show

Solutions:

1. Check in Shopify admin (not just storefront)
2. Verify locale is published in Markets
3. Clear browser cache
4. Check theme supports translations
5. Verify locale switcher is configured
6. Wait 5-10 minutes for CDN cache

Content Issues

”Rich text formatting lost”

Symptoms: HTML/formatting removed in translation

Solutions:

1. Verify HTML is valid in source content
2. Check that rich text fields are properly marked
3. Review translation in the dashboard before registering
4. Contact support if formatting issues persist
5. Report specific examples for investigation

”Special characters corrupted”

Symptoms: Accents, symbols display incorrectly

Solutions:

1. Verify UTF-8 encoding
2. Check browser character encoding
3. Test with simple characters first
4. Report to support with examples

”Translations appear in wrong language”

Symptoms: Content translated to incorrect language

Solutions:

1. Check locale selector is set correctly
2. Verify Markets language mappings
3. Review translation provider logs
4. Check for locale code mismatches
5. Re-translate affected content

Performance Issues

”App loads slowly”

Symptoms: Dashboard takes long to load

Solutions:

1. Check internet connection speed
2. Clear browser cache
3. Disable browser extensions
4. Try different browser
5. Check for large operations in progress

”Translation takes too long”

Symptoms: Translations don’t complete in expected time

Expected Times:

• 100 products: 2-5 minutes
• 1,000 products: 10-20 minutes
• 10,000 products: 1-2 hours

Solutions:

1. Check provider response times
2. Verify adequate provider quota
3. Process in smaller batches
4. Check for rate limiting
5. Monitor Operations page for progress

”Operations queue backed up”

Symptoms: New operations don’t start

Solutions:

1. Wait for current operations to complete
2. Cancel stuck operations
3. Reduce concurrent operations
4. Contact support if queue is stuck

Permission Issues

”Missing permissions” error

Symptoms: Operations fail with permission errors

Solutions:

1. Check LinguaFlow has all required scopes
2. Uninstall and reinstall app
3. Accept all permission requests
4. Verify Shopify admin role
5. Contact support if issue persists

”Access denied” to specific resources

Symptoms: Can’t access certain content types

Solutions:

1. Verify resource type is enabled
2. Check Shopify Plus features (if applicable)
3. Ensure content is published
4. Check for custom access restrictions
5. Review Shopify admin permissions

Data Issues

”Duplicate translations”

Symptoms: Same content translated multiple times

Solutions:

1. Use “Skip existing” option
2. Delete duplicate entries
3. Sync with “Overwrite” disabled
4. Check for multiple locales with same language

”Lost translations”

Symptoms: Previously translated content missing

Solutions:

1. Check translation status (may be unregistered)
2. Search by resource ID
3. Check if content was deleted in Shopify
4. Review Operations history
5. Contact support for data recovery

”Incorrect character count”

Symptoms: Character usage doesn’t match expectations

What Counts:

• All text characters
• Spaces and punctuation
• Line breaks

What Doesn’t Count:

• HTML tags
• JSON syntax
• Metadata fields

Installation Issues

See Installation Guide → Troubleshooting for installation-specific issues.

Browser Issues

Recommended Browsers

• Chrome (recommended): Version 90+
• Firefox: Version 88+
• Safari: Version 14+
• Edge: Version 90+

Browser-Specific Fixes

Clear Cache:

• Chrome: Ctrl+Shift+Delete (Cmd+Shift+Delete on Mac)
• Firefox: Ctrl+Shift+Delete
• Safari: Cmd+Option+E

Disable Extensions:

1. Try incognito/private mode
2. Disable ad blockers
3. Disable privacy extensions
4. Test with extensions disabled

Error Codes

Common Error Codes

Debug Mode

Enable Debug Logging

1. Go to Settings → Advanced
2. Enable “Debug Mode”
3. Reproduce the issue
4. Go to Settings → Logs
5. Download logs
6. Send to support

Getting More Help

Before Contacting Support

1. Check this troubleshooting guide
2. Review FAQ
3. Search documentation
4. Check Shopify status page
5. Check provider status page

Contacting Support

Include these details:

• Description of the issue
• Steps to reproduce
• Expected vs actual behavior
• Screenshots/videos
• Error messages
• Browser and version
• When issue started
• Store URL (if relevant)

Email: [email protected]

Response Times:

• Free: 48 hours
• Starter: 24 hours
• Professional: 12 hours
• Enterprise: 4 hours

Quick Fixes Checklist

Try these first:

• ☐ Refresh the page
• ☐ Clear browser cache
• ☐ Check internet connection
• ☐ Verify API credentials
• ☐ Check provider quota
• ☐ Review Operations history
• ☐ Check Shopify Markets setup
• ☐ Try in incognito mode
• ☐ Test with small batch