Translation Issues

Translation Not Appearing

Symptom: Translated content not showing on site

Solutions:

1. Verify language is enabled in Settings
2. Check that content has been translated
3. Clear browser cache (Ctrl+Shift+Delete or Cmd+Shift+Delete)
4. Verify user's language preference is set correctly
5. Check if translation was published (not just approved)

Poor Translation Quality

Symptom: Translations are awkward, incorrect, or nonsensical

Solutions:

1. Review the AI quality score (aim for 80%+)
2. Check if source text is clear and well-written
3. Add the phrase to translation memory for consistency
4. Use manual override to correct translation
5. Contact support for specific language issues
6. Provide context in source content to improve AI understanding

Inconsistent Terminology

Symptom: Same terms translated differently in different places

Solutions:

1. Add term to translation memory
2. Enable translation memory in settings
3. Review and standardize source terminology
4. Create glossary of key terms
5. Use bulk update to refresh all translations

Performance Issues

Slow Translation Processing

Symptom: Translations take too long to generate

Solutions:

1. Reduce number of languages being translated
2. Enable translation caching
3. Batch translate during off-peak hours
4. Check API rate limits (may have hit limit)
5. Reduce number of parallel translations
6. Check server memory and CPU usage

High API Usage / Costs

Symptom: Translation service bill is higher than expected

Solutions:

1. Enable caching to reduce API calls
2. Translate only essential content
3. Reduce number of target languages
4. Use translation memory to avoid retranslations
5. Batch process translations efficiently
6. Set API rate limits in settings

Site Performance Degradation

Symptom: Site becomes slow after enabling multilingual

Solutions:

1. Enable translation caching
2. Use lazy loading for non-critical languages
3. Compress stored translations
4. Optimize database indexes
5. Reduce number of enabled languages
6. Split translations across multiple servers

Language & Display Issues

Language Not Appearing in Selector

Symptom: Expected language missing from language dropdown

Solutions:

1. Check if language is enabled in settings
2. Verify language code is correct
3. Clear browser cache
4. Verify language has at least one translated item
5. Check user permissions for that language
6. Restart application if recently enabled

RTL Language Layout Broken

Symptom: Right-to-left languages display incorrectly

Solutions:

1. Verify RTL language (Arabic, Hebrew, Persian, Urdu)
2. Check CSS includes RTL styling
3. Ensure theme supports RTL
4. Clear browser cache
5. Test in different browser
6. Check font includes RTL character support

Character Encoding Issues

Symptom: Special characters appear as boxes or gibberish

Solutions:

1. Verify UTF-8 encoding is enabled
2. Check font supports the character set
3. Verify database uses UTF-8 collation
4. Check HTML meta charset tag
5. Restart browser cache
6. Test with different browser

Text Overflowing Layout

Symptom: Translated text extends beyond UI boundaries

Solutions:

1. Some languages use longer words (German, Finnish)
2. Design for longer text in all languages
3. Use flexible layout instead of fixed widths
4. Test layout with all enabled languages
5. Adjust font size for longer languages
6. Use text truncation with ellipsis if needed

User Experience Issues

Users Seeing Wrong Language

Symptom: User content not displayed in their language

Solutions:

1. Verify user language preference is saved
2. Check browser language settings
3. Clear browser cookies and cache
4. Verify translation exists for that language
5. Check if language is enabled site-wide
6. Verify translation was published

Language Selection Not Working

Symptom: Clicking language selector doesn't change language

Solutions:

1. Refresh page after selecting language
2. Check browser JavaScript is enabled
3. Clear browser cache
4. Verify language selector is active
5. Check browser console for JavaScript errors
6. Try different browser

Partial Translation

Symptom: Only some content appears in selected language

Solutions:

1. Not all content may be translated yet
2. Some content may not have translation enabled
3. Translation may be pending approval
4. Check Admin Dashboard for translation status
5. Manually translate missing content
6. Enable automatic translation for new content

API & Configuration Issues

API Key Not Working

Symptom: Translation service returns authentication error

Solutions:

1. Verify API key is entered correctly
2. Check if API key has expired
3. Verify API key has proper permissions
4. Regenerate API key if needed
5. Check rate limits haven't been exceeded
6. Verify translation service is active

Unsupported Language Error

Symptom: Error when attempting to use certain language

Solutions:

1. Verify language is in supported list
2. Check language code format is correct
3. Language may need to be added to system
4. Request new language support
5. Use closest alternative language
6. Contact support for custom language

Configuration Won't Save

Symptom: Settings changes not persisting

Solutions:

1. Verify you have admin permissions
2. Check database connection
3. Ensure disk space available
4. Clear browser cache
5. Try again in private/incognito mode
6. Check server error logs

Performance & Monitoring

Check Translation Status

1. Go to Translations > Dashboard
2. View translation progress
3. See completed vs. pending
4. Monitor error rate
5. Check API usage

Monitor Cache Performance

1. Go to Settings > Performance
2. View cache hit rate
3. Monitor cache size
4. Check cache effectiveness
5. Clear if needed

View Error Logs

1. Go to AI Multilingual > Logs
2. Filter by error type
3. Search by date or language
4. Download error reports
5. Review for patterns

Getting Help

When to Contact Support

• Persistent translation quality issues
• API errors or rate limiting problems
• Custom language requirements
• Performance issues affecting users
• Unexpected behavior after updates

Information to Provide

• Plugin version
• Affected languages
• Error messages (exact text)
• Steps to reproduce
• Screenshots if applicable
• Browser and OS information

Next Steps

• Best Practices — Optimization guide
• Supported Languages — Language reference