DocumentationGetting Started

Getting Started

This guide will walk you through setting up LinguaFlow and translating your first content.

Prerequisites

Before you begin, make sure you have:

  • A Shopify store (any plan)
  • Admin access to your Shopify store
  • Shopify Markets configured with at least one additional locale
⚠️

Important: You must set up Shopify Markets and add target locales before installing LinguaFlow. Learn how in the Shopify Markets documentation.

Installation

Step 1: Install from Shopify App Store

  1. Visit the LinguaFlow listing on the Shopify App Store
  2. Click “Install app”
  3. Review and accept the requested permissions
  4. Click “Install” to complete the installation

The app will request the following permissions:

  • Read and write translations
  • Read and write products
  • Read and write content
  • Read markets and locales
  • Additional resource-specific permissions

Step 2: Complete Initial Setup

After installation, you’ll be directed to the LinguaFlow dashboard where you can complete the setup wizard. The app is ready to use immediately - no additional configuration required!

Your First Translation

Now that LinguaFlow is installed, let’s translate some content!

Step 1: Select Target Language

  1. From the LinguaFlow dashboard, click “Select Language”
  2. Choose a target locale from your configured Shopify Markets locales
  3. The dashboard will update to show content for that locale

Step 2: Sync Content

Before translating, sync your store content:

  1. Click “Sync & Translate” in the top navigation
  2. Select the resource types you want to sync (e.g., Products, Collections)
  3. Click “Sync Content”
  4. Wait for the sync to complete

This imports all translatable content from your Shopify store.

Step 3: Translate Content

Now translate your synced content:

  1. Click “Translate All” or select specific resources
  2. Review the translation settings
  3. Click “Start Translation”
  4. Monitor progress in real-time

Translations are processed in the background. You can continue working while they complete.

Step 4: Register Translations

Once translations are complete, publish them to your store:

  1. Review translated content in the “Manage Translations” view
  2. Click “Register All” or select specific translations
  3. Confirm the registration
  4. Translations will be published to your Shopify store

Verify Your Translations

After registration, verify that translations appear correctly:

  1. Go to your Shopify admin
  2. Navigate to a translated resource (e.g., a product)
  3. Click the language selector
  4. Switch to your target locale
  5. Verify the translated content appears correctly

Next Steps

Congratulations! You’ve completed your first translation. Here are some next steps:

Common Issues

”No locales found”

Make sure you’ve configured Shopify Markets and added at least one additional locale to your store.

”Translation failed”

Check your character usage in the dashboard and ensure your subscription is active. If the issue persists, contact support.

”Content not syncing”

Verify that LinguaFlow has the required permissions. You may need to reinstall the app.

Need more help? Check our Troubleshooting guide or contact support.

OverviewInstallation