DocumentationInstallation

Installation Guide

Complete installation instructions for LinguaFlow.

Prerequisites

Before installing LinguaFlow, ensure you have:

Shopify Store Requirements

  • Active Shopify store (any plan: Basic, Shopify, Advanced, or Plus)
  • Admin access to your store
  • Store using Shopify Online Store 2.0 or newer (recommended)

Shopify Markets Setup

LinguaFlow requires Shopify Markets to be configured:

  1. Go to Settings → Markets in your Shopify admin
  2. Create or configure markets for your target regions
  3. Add languages (locales) to your markets
  4. Ensure at least one additional locale beyond your primary language
⚠️

Required: You must have at least one additional locale configured in Shopify Markets before installing LinguaFlow.

Learn how to set up Shopify Markets →

Good news! Translation service is included with your LinguaFlow subscription. No additional accounts or setup required!

Installation Steps

Step 1: Find LinguaFlow in App Store

  1. Log in to your Shopify admin
  2. Go to Apps in the left sidebar
  3. Click Customize your store or visit the Shopify App Store
  4. Search for “LinguaFlow”
  5. Click on the LinguaFlow app listing

Step 2: Review App Details

Before installing:

  • Review the app description and features
  • Check the pricing plans
  • Read recent reviews from other merchants
  • Review the requested permissions

Step 3: Install the App

  1. Click Install app or Add app
  2. Review the permissions requested by LinguaFlow
  3. Click Install to authorize the app

Requested Permissions

LinguaFlow requires the following permissions:

  • Read translations - To fetch existing translations from your store
  • Write translations - To publish translated content
  • Read products - To access product information for translation
  • Write products - To update product translations
  • Read collections - To translate collection content
  • Write collections - To publish collection translations
  • Read content - To access pages, blogs, and articles
  • Write content - To update content translations
  • Read online store navigation - To translate menus and links
  • Write online store navigation - To update menu translations
  • Read themes - To translate theme content
  • Read markets - To access your configured locales
  • Read metaobjects - To translate custom content
  • Write metaobjects - To update metaobject translations

These permissions are necessary for LinguaFlow to function properly. Without them, the app cannot translate and publish your content.

Step 4: Initial Setup Wizard

After installation, you’ll be guided through a simple setup wizard:

  1. Welcome Screen - Introduction to LinguaFlow
  2. Locale Verification - Confirm your target languages
  3. Initial Sync - Optional first content synchronization

The translation service is automatically configured - you can start translating immediately!

Post-Installation Verification

Verify Installation

Test that everything is working:

  1. Check that LinguaFlow appears in your Shopify apps list
  2. Open the LinguaFlow dashboard
  3. Verify your target locales appear in the language selector
  4. Try syncing a small amount of content (e.g., one product)
  5. Translate the synced content
  6. Check that translation completes successfully

Troubleshooting Installation

”App failed to install”

Possible causes:

  • Browser cache or cookie issues
  • Ad blocker interference
  • Insufficient permissions
  • Network connectivity issues

Solutions:

  1. Clear browser cache and cookies
  2. Disable ad blockers temporarily
  3. Try a different browser (Chrome recommended)
  4. Ensure you’re logged in as store owner/admin
  5. Contact support if issue persists

”Permissions denied”

Solution:

  1. Uninstall the app completely
  2. Clear browser cache
  3. Reinstall and accept all permissions
  4. Do not skip or deny any permission requests

”No locales found”

Solution:

  1. Verify Shopify Markets is configured
  2. Ensure you’ve added at least one additional locale
  3. Check that locales are not in “draft” status
  4. Refresh LinguaFlow dashboard
  5. If issue persists, try uninstalling and reinstalling

”Translation service error”

Solution:

  1. Verify your subscription is active
  2. Check character usage hasn’t exceeded plan limits
  3. Try again in a few moments
  4. Clear browser cache and refresh
  5. Contact support if issue persists

Uninstalling LinguaFlow

If you need to uninstall:

Backup Your Translations

Before uninstalling, optionally export your translations:

  1. Go to Manage Translations
  2. Export translations for backup
  3. Save the exported file

Uninstall from Shopify

  1. Go to Apps in your Shopify admin
  2. Find LinguaFlow in your installed apps
  3. Click Delete or Uninstall
  4. Confirm the uninstallation

Data Retention

After uninstalling:

  • Your data is retained for 30 days
  • Translations remain in your Shopify store
  • Contact support to permanently delete data immediately
  • No refunds for remaining subscription period (except as per terms)

Translations published to your store remain even after uninstalling LinguaFlow. They’re stored in Shopify’s translation system.

Reinstalling LinguaFlow

If you reinstall within 30 days:

  • Your previous translations may still be available
  • Your settings will need to be reconfigured
  • Subscription will resume from installation date

Next Steps

After successful installation:

  1. Configure your settings
  2. Follow the getting started guide
  3. Learn about bulk translation
  4. Review best practices

Need help? Contact Support →

Getting StartedConfiguration