Translation Apps Integration Guide

Enable automatic multilingual support for your Bird Pickup & Delivery widget by integrating with popular translation apps.

Bird automatically detects your customers' preferred language. It displays widget labels, checkout text, and notifications in that language. This guide shows you how to set up the integration.

What This Integration Does

Bird integrates with translation apps to provide seamless multilingual experiences. The widget automatically displays in your customer's selected language. No manual configuration needed after initial setup.

Bird translates these elements automatically:

• Widget labels: Pickup, delivery, and shipping method names
• Time slot labels: Day names, time formats, availability messages
• Form fields: Input labels, placeholders, validation messages
• Checkout integration: Locale-specific checkout parameters
• Order notes: Delivery and pickup information added to Shopify order notes in the customer's language (method names, dates, and times are automatically translated and formatted)
• Notifications: Email notifications (when configured per language)

Bird only translates its own interface. Your translation app handles all other store content. This includes product descriptions and store pages.

Supported Translation Apps

Bird works with these translation solutions:

1. Shopify Translate & Adapt - Native Shopify translation solution
2. Weglot - Automatic language detection and integration

How the Integration Works

Bird detects language automatically when customers visit your store. For Weglot, Bird checks if the app is initialized. For Shopify Translate & Adapt, Bird reads the HTML lang attribute that the app sets on your storefront.

The integration requires no code changes. Bird handles language detection automatically.

No special configuration needed. Configure languages in Bird and ensure your translation app is working. The integration is automatic. Just ensure language codes match between both systems.

Set Up Your Translation App

Configure your translation app first. Then configure languages in Bird.

For Weglot Users

1. Install Weglot from the Shopify App Store
2. Configure Weglot with your desired languages
3. You're done - Bird automatically detects Weglot

Bird checks for Weglot initialization on your storefront. No additional configuration needed.

For Shopify Translate & Adapt Users

1. Install Shopify Translate & Adapt from the Shopify App Store
2. Configure your languages in the app
3. You're done - Bird automatically detects the language

Bird reads the HTML lang attribute that Shopify Translate & Adapt sets on your storefront. No additional code needed.

Configure Languages in Bird

Set up languages in Bird to match your translation app. This enables the widget to display in multiple languages.

Add Languages to Bird

1. Navigate to Bird Settings > Text and Languages
2. Click Add Language for each language you want to support
3. Select the language code that matches your translation app
4. Configure translations for all labels
5. Set up checkout locale settings if using multiple fulfillment methods
6. You're done - The language is now configured

Match Language Codes

Examples:

• Weglot uses fr > Configure fr in Bird > Works perfectly
• Shopify Translate & Adapt uses fr-CA > Configure fr-CA in Bird > Works perfectly
• Weglot uses fr > Configure fr-FR in Bird > May not match correctly

If a language isn't configured in Bird, Bird falls back to your default language. The widget displays in the default language. Other parts of your store still show in the customer's selected language. Your translation app handles those translations.

Bird is flexible with language code matching if your translation app uses a different format. Bird tries matching in this order:

1. Exact match (with dashes removed from the language code)
2. Language code match (first part before -)
3. Partial match (language code starts with the first part)
4. Default language

For best results, use matching language codes.

How to Find Language Codes

Shopify Translate & Adapt: Shows the country code during setup, or you can view your storefront URL after switching the language.

Weglot: Weglot displays language names (like "French") in its interface. You can match these names in Bird's Text and Languages settings. To double-check the actual language code, open your storefront with Weglot enabled. Open browser console. Type window.Weglot.getCurrentLang()

You may contact our support if you need any help. Learn more about customizing widget language and labels: How to Customize Widget Language and Labels

Configure Checkout Locales

Set up checkout locales for each language when using multiple fulfillment methods. This ensures proper date, time, and currency formatting.

Set Up Checkout Locales

1. Go to Bird Settings > Text and Languages > Select a language
2. Scroll to Checkout Page Settings
3. Configure the locale for each fulfillment method
4. Set Pickup locale (e.g., en-default, fr-CA)
5. Set Delivery locale
6. Set Shipping locale
7. You're done - Checkout will display in the correct language

The correct locale ensures customers see properly formatted information. Missing locale configuration may cause checkout to display in the wrong language.

Learn more about checkout locale configuration: Setup checkout locales files

Protect Metafields from Translation

Verify Metafields Are Protected

Test your setup to ensure metafields are not being translated.

1. Switch between languages on your storefront
2. Verify the widget loads correctly in each language
3. Change your store's language using your translation app
4. Refresh the page
5. Verify the widget displays correctly

If the widget fails to load or shows errors, metafields may have been translated. Exclude them from translation and test again. You may contact support if you need help.

Verify the Integration Is Working

Test the integration with these steps:

1. Change your store's language using your translation app
2. Refresh the page
3. Check if the Bird widget displays in the new language

Updated on: 01/08/2026