Configuration Guide

Learn how to configure LinguaFlow for your specific needs.

Translation Service

LinguaFlow uses enterprise-grade AI translation, providing high-quality translation for 100+ languages.

Service Configuration

The translation service is automatically configured for all shops - no manual setup required!

What’s Included:

• High-quality neural machine translation
• Support for 100+ languages worldwide
• Automatic character usage tracking
• Real-time translation processing
• Enterprise-grade reliability

Character Usage Tracking:

• LinguaFlow automatically tracks translation character usage
• View usage statistics in your dashboard
• Monitor costs in real-time
• Get usage alerts before hitting limits

Translation Quality:

• Enterprise-grade neural translation
• Optimized for e-commerce content
• Support for technical terminology
• HTML and formatting preservation
• Context-aware translations

Metadata Settings

Configure which metafields and metaobjects to translate through the dedicated UI.

Accessing Metadata Settings

1. Navigate to /app/metadata-settings in your LinguaFlow dashboard
2. View available metafield definitions and metaobject types
3. Configure translation preferences for each

Metafields Configuration

MetafieldsSettingsCard allows you to:

• Browse all metafield definitions in your store
• Select which metafields should be translatable
• Enable/disable translation per metafield type
• Settings stored per-shop in session data

Supported Metafield Types:

• Single line text
• Multi-line text
• Rich text
• JSON (with translatable content)

Metaobjects Configuration

MetaobjectsSettingsCard provides field-level control:

• View all metaobject definitions
• Configure which fields within each metaobject type are translatable
• Field-level granular control
• Persist settings per-shop

Use Cases:

• Custom content types (FAQs, testimonials)
• Product supplements (size guides, care instructions)
• Brand stories and landing page content
• Dynamic page sections

Resource Type Configuration

Configure which content types to translate and how.

Enable/Disable Resource Types

Control which resource types are available for translation:

1. Go to Settings → Resource Types
2. Toggle each resource type on/off:
   • Products
   • Collections
   • Pages
   • Blog Posts
   • Menus
   • Policies
   • Metaobjects
   • And more…

Per-Resource Settings

Configure behavior for each resource type:

Products

• Translate product title
• Translate description
• Translate SEO fields
• Translate metafields
• Translate vendor name
• Translate product type

Collections

• Translate collection title
• Translate description
• Translate SEO fields

Pages

• Translate page title
• Translate body content
• Translate SEO fields

Blog Posts & Articles

• Translate title
• Translate content
• Translate excerpt
• Translate SEO fields

Metafields & Metaobjects

• Field-level configuration available via Metadata Settings
• Configure translatable fields per metaobject type
• Select which metafield definitions to translate
• No hardcoding required

Locale Configuration

Managing Target Locales

Configure which languages to translate to:

1. View Active Locales

   • See all locales from Shopify Markets
   • Check locale status and availability

2. Locale Priority

   • Set translation priority for each locale
   • High-priority locales processed first in bulk operations

3. Default Source Language

   • Set your primary store language
   • Used as source for all translations

Locale-Specific Settings

Regional Preferences

• Currency handling in translated content
• Date/time format preferences
• Number formatting
• Regional product variations

Translation Behavior

• Auto-translate new content
• Translation approval workflow
• Quality thresholds

Workflow Configuration

Automation Settings

Auto-Sync

• Enable automatic content synchronization
• Sync frequency: Daily, Weekly, Manual
• Resource types to auto-sync
• Sync time preference

Auto-Translate

• Automatically translate new content
• Configure translation triggers
• Set target locales for auto-translation
• Define content filters

Auto-Register

• Automatically publish completed translations
• Quality check before registration
• Notification preferences

Approval Workflow

Translation Review

• Require manual review before publishing
• Assign reviewers by locale
• Review deadline reminders
• Approval notifications

Quality Checks

• Minimum character count validation
• HTML integrity verification
• Placeholder preservation check
• Link validity verification

Notification Settings

Email Notifications

Configure email alerts for:

• Translation completion
• Registration success/failure
• Sync completion
• Error alerts
• Usage warnings
• Quota alerts

Notification Frequency

• Immediate: Sent as events occur
• Daily digest: Once per day summary
• Weekly digest: Weekly summary
• Off: No notifications

In-App Notifications

• Real-time operation updates
• Error and warning messages
• System announcements
• Feature updates

Advanced Settings

Performance Tuning

Batch Sizes

• Translation batch size: 50-1000 items
• Registration batch size: 50-500 items
• Sync batch size: 100-5000 items

Concurrency

• Parallel translation requests: 1-10
• Parallel registrations: 1-5
• API rate limiting

Timeouts

• Translation timeout: 30-300 seconds
• Registration timeout: 30-180 seconds
• Sync timeout: 60-600 seconds

Caching Configuration

Translation Cache

• Enable cache for repeated content
• Cache duration: 7-90 days
• Cache size limit
• Auto-cache invalidation

API Response Cache

• Shopify API response caching
• Reduce API calls for read operations
• Cache TTL configuration

Debug Settings

Enable for troubleshooting:

• Verbose logging
• API request/response logging
• Translation diff tracking
• Performance profiling

Security Settings

API Credential Management

• Credential Storage: Encrypted at rest
• Rotation: Update credentials without downtime
• Access Logs: View credential usage history
• Revocation: Immediately revoke access

Access Control

User Permissions (Enterprise)

• Admin: Full access
• Manager: Translate and manage
• Translator: Translate only
• Reviewer: Review and approve

Data Privacy

• Data Retention: Configure retention period
• Data Export: Export all your data
• Data Deletion: Request data deletion
• Audit Logs: View data access logs

Backup & Restore

Backup Configuration

• Automatic Backups: Daily backups of translations
• Manual Backups: On-demand export
• Backup Storage: 30-day retention
• Backup Format: JSON or CSV

Restore Options

• Restore specific translations
• Restore entire locale
• Restore from date
• Selective restore by resource type

Configuration Best Practices

1. Start Conservative: Begin with default settings
2. Test Small: Test configuration changes with small batches
3. Monitor Performance: Watch for rate limit errors
4. Enable Notifications: Stay informed of issues
5. Regular Backups: Export translations regularly
6. Review Logs: Check logs for optimization opportunities

Need help configuring? Contact Support →