To translate a bundle widget on Shopify, you need to translate the copy inside your bundle app as well as your product catalog. Shopify’s language settings translate your product titles, descriptions and checkout, while your bundle app holds the tier titles, savings badges and system labels rendered inside the widget.
When those widget labels stay in English on a French, German or Spanish product page, shoppers hesitate right above the buy button. This guide covers what needs translating in a multilingual bundle setup, how to translate storewide and offer-specific texts in Sam Bundles, and how to keep dynamic price variables working across languages. For a broader look at offer types and margin math, start with our product bundles guide.
Why does an untranslated bundle widget hurt international checkout?
Customers prefer to shop in their own language, and Shopify gives each published language on your store its own URLs and translated checkout (Shopify Help Center). When a shopper lands on /fr/products/... or /de/products/..., they expect the entire product form to match.
A bundle widget sits directly inside that product form. If the page title and Add to cart button are in German, but the quantity selector between them reads “Buy more, save more — Most Popular — SAVE $12”, the offer looks like an untranslated plugin or a region-locked promo.
On a multilingual Shopify store, different parts of a bundle offer live in different places:
| Part of the bundle offer | Where the text lives | How you translate it |
|---|---|---|
| Product titles, option names and variant names | Shopify catalog (Products) | Shopify Translate & Adapt, CSV import, or a translation app |
| Theme buttons outside the widget | Theme locale files (Online Store > Themes) | Theme language editor or Translate & Adapt |
Widget system labels (SOLD OUT, FREE, Free gifts, error alerts) | Bundle app storewide settings | Translations page in the Sam Bundles menu (General card) |
| Offer block title, bar titles, subtitles, badges and add-on titles | Individual offer configuration | Translations button at the top of the quantity breaks or BOGO editor |
| Automatic discount label in the cart and at checkout | Offer Settings > Discount name | Single cross-market label set in the offer editor |
Knowing which layer holds which string saves you from hunting through theme files for a badge that actually lives in your bundle app.
What is the difference between storewide widget strings and offer texts?
In Sam Bundles, bundle app translation is split into two scopes so you don’t have to re-translate words like “Sold out” or “Free” every time you launch a new deal (translate the bundle widget).
1. Storewide system strings (the General card)
The General card on the Translations page holds eight built-in interface strings shared across quantity breaks and buy X get Y widgets:
| Original system text | Where shoppers see it |
|---|---|
SOLD OUT | Badge on an out-of-stock gift item |
Sold out | Suffix inside the variant dropdown when a gift variant is unavailable |
FREE | Price tag on a free gift item |
Gift | Fallback gift name and image alt text |
Free gifts | Default summary line on a bar with gifts when that bar is not selected |
Select gift option | Accessible label (aria-label) on the gift variant dropdown |
Could not add items to cart. Please try again. | Alert if Shopify rejects the add-to-cart request |
A network error occurred. Please check your connection and try again. | Alert if the connection drops while adding to cart |
You translate these eight rows once per language, and every quantity breaks or BOGO widget on your store uses them automatically.
2. Offer-specific texts (inside each deal)
The words you write for a specific deal—such as “Stock up & save” or “Duo (2 packs)“—change from offer to offer. When you click Translations inside a quantity breaks or buy X, get Y editor, Sam Bundles lists only the non-empty text fields you actually use in that deal:
- Block title and Description from the offer’s Settings card.
- Bar #1, Bar #2, Bar #3… fields: Title, Subtitle, Label (the savings pill on the bar), Badge (when the highlight badge is enabled), and Gifts summary (when a free gift is attached to that bar).
- Add-on texts (shown only when the add-on is switched on): Countdown timer · Title, Savings summary · Title, Sticky add to cart · Title, and Sticky add to cart · Button.
If you leave a bar’s subtitle blank or keep the countdown timer turned off, those rows stay hidden so the translation table stays short.
How do you translate a bundle widget step by step in Sam Bundles?
Follow these four steps to set up multilingual bundles in Sam Bundles. The app is free on the Shopify App Store.
Step 1: Publish your languages in Shopify
Add and publish your target languages in your Shopify admin under Settings > Languages (Shopify Help Center). Sam Bundles reads your store’s published locales to populate its Language picker (and falls back to a built-in list of 30 languages if your store hasn’t granted locale read access yet).
Step 2: Translate the General system strings once
- Open Sam Bundles in your Shopify admin and click Translations in the app menu.
- Choose the store language you want to translate from the Language dropdown.
- In the General card, type the translation next to each original text (
SOLD OUT,FREE,Free giftsand the error messages). - Click Save.
Step 3: Open Translations from your quantity breaks or BOGO offer
- On the Sam Bundles home page, scroll to Offers and open your Quantity breaks or Buy X, get Y (BXGY) offer (or create an offer first).
- If the offer is new, click Save once so the Translations button at the top of the editor unlocks.
- Click Translations in the top header of the offer editor.
Step 4: Translate each bar and add-on, then save
- Select a non-default language in the Language dropdown. (When your default store language is selected, the page notes that default-language text is edited in the deal editor.)
- Below the General card, find the card titled with your offer’s name.
- Fill in the translated text for your Block title, each bar’s Title, Subtitle, Label and Badge, and any enabled add-ons.
- Click Save, then switch the Language dropdown to your next language and repeat.
See the translations guide in the Sam Bundles docs for a screenshot of each field.
How do dynamic variables work when you translate bundle tiers?
Quantity breaks and buy X get Y offers use dynamic tokens inside double curly braces so prices and quantities update automatically. When you translate a field that contains a variable, keep the token name inside {{...}} untouched and translate only the words around it.
| Variable token | What it outputs on the storefront | Where it is used |
|---|---|---|
{{product_buy}} | Quantity of items the customer buys in that bar | Bar Title and Subtitle |
{{product_get}} | Quantity of free or discounted items in a BXGY bar | Buy X, get Y bar Title and Subtitle |
{{saved_percentage}} | Rounded percentage saved on that bar (includes %) | Bar Title, Subtitle and Label badge |
{{saved_total}} | Total amount saved on that bar, formatted in store money | Bar Title, Subtitle, Label badge and Savings summary · Title |
{{timer}} | Live countdown clock (MM:SS or HH:MM:SS) | Countdown timer · Title |
Here is an example of how a two-pack bar and savings summary look across four languages while keeping every variable intact:
| Field | Original (English) | French (fr) | German (de) | Spanish (es) |
|---|---|---|---|---|
| Block title | Buy more, save more | Achetez plus, économisez plus | Mehr kaufen, mehr sparen | Compra más y ahorra |
| Bar #2 · Title | Duo ({{product_buy}} items) | Duo ({{product_buy}} articles) | Duo ({{product_buy}} Stück) | Dúo ({{product_buy}} unidades) |
| Bar #2 · Subtitle | You save {{saved_percentage}} | Vous économisez {{saved_percentage}} | Du sparst {{saved_percentage}} | Ahorras un {{saved_percentage}} |
| Bar #2 · Label | SAVE {{saved_total}} | ÉCONOMISEZ {{saved_total}} | SPARE {{saved_total}} | AHORRA {{saved_total}} |
| Bar #2 · Badge | Most Popular | Le plus populaire | Bestseller | Más popular |
| Savings summary · Title | You're saving {{saved_total}} on this order | Vous économisez {{saved_total}} sur cette commande | Du sparst {{saved_total}} bei dieser Bestellung | Estás ahorrando {{saved_total}} en este pedido |
Keep three rules in mind when translating fields with variables:
- Never translate the word inside the braces. Writing
{{economie_totale}}breaks the token; the storefront script only replaces the exact keys ({{saved_total}},{{saved_percentage}},{{product_buy}},{{product_get}},{{timer}}). - No extra percent sign needed.
{{saved_percentage}}includes the%symbol automatically (and absorbs a trailing%if you write{{saved_percentage}}%, preventing15%%). - Keep badge labels compact. Words like
ÉCONOMISEZare wider thanSAVE. On narrow mobile screens, a shorter pill like-{{saved_percentage}}orSPARE {{saved_total}}keeps the bar header from wrapping. See our bundle widget design guide for mobile layout tips.
How does language matching and fallback work on the storefront?
In Shopify Liquid, every storefront request exposes the shopper’s active locale code in IETF format (request.locale.iso_code), such as en, fr, de or pt-BR (Shopify.dev). The Sam Bundles app embed passes that locale code to the widget alongside your saved translations.
When a product page loads, the widget resolves each text field in three steps:
- Exact locale match: Checks for a saved translation matching the full locale code (such as
pt-BRorzh-TW). - Base language match: If no regional entry exists, matches the base language code before the hyphen (so
fr-CAorpt-BRuses yourfrorpttranslation). - Field-by-field fallback to original: Any field left blank in that language displays your original text rather than an empty string.
Because fallback works per field, translate every visible field in an offer before promoting a new language so shoppers never see a French bar title next to an English Most Popular badge.
How should you handle multi-product bundles and checkout discount names?
Two parts of a bundle setup work differently from the per-offer translation table in quantity breaks and BOGO deals.
Mix & Match, Bundle Builder and Fixed Bundle offers
In Sam Bundles, the per-offer Translations button is built into Quantity breaks and Buy X, get Y (BXGY) offers. Mix & Match, Bundle Builder and Product Fixed Bundle offers store their widget title, description and labels in a single Settings card inside the offer editor.
If you sell in multiple languages and run multi-product bundles:
- Translate product and variant titles in Shopify. Multi-product bundles display your catalog’s product names, which follow your Shopify translations.
- Use quantity breaks with Complete the bundle when you need per-language widget copy. Inside any quantity breaks bar, Complete the bundle attaches complementary products at that bar’s discount while keeping full access to the quantity breaks Translations button. See fixed bundles vs mix and match vs bundle builder for how each format works.
- Use concise, cross-market headings such as
Bundle -15%orPack Triowhen a single widget heading serves multiple European languages.
Checkout Discount name and local currencies
When a shopper picks a quantity break or BOGO tier, Sam Bundles applies the discount at checkout using the Discount name from the offer’s Settings card (see how bundle discounts apply at checkout). Because Shopify’s automatic discount uses one Discount name across locales, use a short code-style label that works in every market—such as DUO -15%, BUNDLE -15% or BOGO 2x1 instead of a long English phrase.
If you sell in multiple currencies with Shopify Markets (Shopify Help Center), set your tiers to Percentage off rather than a fixed amount off so the discount scales cleanly across currencies.
What checklist should you run after translating your bundle widget?
Run this five-step check on your storefront before sending international traffic to a translated offer:
- Switch languages with your storefront selector. Open an eligible product page and switch through each published language to confirm the block title, bar titles, subtitles and badges all update.
- Verify every variable. Check that
{{saved_total}},{{saved_percentage}},{{product_buy}}and{{timer}}render numbers and prices rather than raw curly braces. - Check mobile wrapping. Preview the page on a phone width in German, French or Spanish, where translated phrases often run longer than English, and shorten any badge that crowds the price.
- Test gift and sold-out labels. If an offer includes a free gift, confirm that
FREE,Free giftsand variant dropdown labels use your General translations. - Add a tier to the cart and visit checkout. Verify that the automatic discount applies and your Discount name reads cleanly next to the translated order summary.
If you also run sales popups, low-stock counters or announcement bars for international visitors, pair this setup with our guide to localized social proof so every widget on your product page matches the shopper’s language.
Frequently asked questions
How do I translate a bundle widget in Sam Bundles?
Open Translations in the Sam Bundles app menu, choose a language from the Language dropdown, type your translations next to the General system texts (such as SOLD OUT and FREE), and click Save. To translate the titles, subtitles and badges of a quantity breaks or buy X get Y offer, open that offer in the editor and click the Translations button at the top.
What happens if I leave a translation field blank?
Any field you leave blank in Translations falls back to the original text you wrote in the offer editor or the default English system label. You can translate your main tier titles and badges first, save, and fill in optional subtitles or error messages later.
How do variables like {{saved_total}} work in translated bundle offers?
Dynamic tokens such as {{product_buy}}, {{product_get}}, {{saved_percentage}}, {{saved_total}} and {{timer}} are replaced with numbers on the storefront. Keep the exact variable name inside the double curly braces and translate only the words around it, for example ÉCONOMISEZ {{saved_total}} in French.
Which bundle offer types have per-offer translation settings in Sam Bundles?
Quantity breaks (including quantity breaks with a free gift) and buy X, get Y (BOGO) offers have a dedicated Translations button at the top of the offer editor for block titles, bar titles, subtitles, badges and add-on texts. Mix and match, bundle builder and fixed bundle offers use a single Settings card for their widget headings.
How does the bundle widget know which language a shopper is browsing in?
The storefront app embed reads the active locale code from Shopify (request.locale.iso_code) and matches it to your saved translations. If a regional language code such as pt-BR does not have its own entry, the widget falls back to the base language code (pt) before falling back to your original text.
Sources
Part of our guide: Product bundles →