> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.hoppyapps.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 🌍 Bundles Offer — Translation

Hoppy Bundles allows merchants to create translations for the customer-facing texts shown inside their bundle offers.

This helps stores provide a more localized shopping experience for customers browsing the storefront in different languages ✨

Translations can be added for any offer type in Hoppy Bundles:

* 📦 Bundle / Combo offers  
* 📊 Quantity Breaks (Volume Discounts)  
* 🗂️ Category Quantity Breaks  
* 🧱 Build Your Own Bundle (BYOB)  
* 🛍️ Frequently Bought Together / Upsell Slider  
* ➕ Product Add-ons

Depending on the offer type, you can translate things like:

* 🏷️ Offer Title  
* 📝 Description, Footer text & Total text  
* 🔘 Button (CTA) texts  
* 🎖️ Discount labels, Tags, Subtitles & the Highlighted Tag  
* 📌 BYOB Sticky Bar text

---

# **🌐 Before Adding Translations**

Before translations can be added inside Hoppy Bundles, the language must already exist inside your Shopify store settings.

Hoppy Bundles automatically detects the languages configured in:

→ **Shopify Admin → Settings → Languages**

Only the languages configured there will become available inside the app for translation.

⚠️ Important:

* If a language is not added in Shopify Settings first, it will not appear in the Translation section inside Hoppy Bundles.  
* Your store's **primary (default) language** is not listed — the offer texts you write while creating the offer are already in that language. Translations are only needed for your *additional* languages.

💡 Inside the Translation section there is a shortcut link — **"Add languages in Shopify Settings to translate"** — that takes you straight to **Shopify Admin → Settings → Languages** if you need to add a new language first.

---

# **🛠️ Step 1 — Open Hoppy Bundles**

Open the **Hoppy Bundles** app from your Shopify Admin.

Then:

→ Open an existing offer → Or create a new offer (Bundle, Quantity Break, BYOB, Upsell, Add-ons — translations work the same way for all of them)

---

# **🎯 Step 2 — Navigate to the Translation Section**

Once the offer setup is opened:

→ Make sure you are inside the **General** tab → Scroll toward the bottom of the setup page → Locate the **Translation** section This section allows you to add translated versions of the customer-facing texts shown in the offer widget on your storefront.

---

# **➕ Step 3 — Add a Translation**

Inside the Translation section:

→ Click **Add translation**

Once clicked, a Translation modal will appear.

Inside this modal, you can:

* Select the language  
* Enter the translated texts for your offer  
* Configure storefront-facing translation content

💡 The language dropdown only shows languages that don't have a translation yet. To translate into more languages, simply add them one by one.

---

# **✍️ Step 4 — Configure Translation Content**

Inside the Translation modal, manually enter the translated text you want customers to see on the storefront.

The fields available depend on the offer type:

**📦 Bundle, Category Quantity Break, Upsell Slider & Product Add-ons:**

* Title  
* Footer text  
* Total text  
* CTA text (the button label)  
* Highlighted Tag

**📊 Quantity Breaks (Volume Discounts)** — everything above, plus per-offer-tier texts:

* Offer title  
* Discount Label  
* Tag  
* Subtitle

**🧱 Build Your Own Bundle (BYOB):**

* Title  
* Description  
* CTA text  
* Sticky Bar Text  
* Product Card CTA Text (the "Add" button on each product)

⚠️ Important:

For **BYOB Sticky Bar Text**, do not remove the dynamic variable:

* `{target}`

This variable is required — it gets replaced with the required quantity on the storefront.

## **💡 Example Translation**

If your base Sticky Bar Text is:

**"Add {target} more items to get the discount"**

then a French translation could look like:

**"Ajoutez {target} articles de plus pour obtenir la réduction"**

Notice that the variable `{target}` is still preserved inside the translated message.

This ensures the quantity updates dynamically on the storefront ✨

---

# **✅ Step 5 — Confirm & Save**

Once the translations are added:

→ Click **Confirm translation** inside the modal → Click **Save** on the offer setup page → Publish the offer (if not already live)

After saving, customers browsing your storefront in the selected language will automatically see the translated offer texts.

This creates a more localized and user-friendly storefront experience 🌍

---

# **✏️ Managing Existing Translations**

Every translation you add appears as a row inside the Translation section.

Click the **⋯ (more options)** button next to a language to:

* **Edit translation** — update the translated texts anytime  
* **Delete** — remove the translation completely

⚠️ Important:

Deleting a translation can't be undone — the app will ask you to confirm before removing it.

---

# **🛒 How Translations Behave on the Storefront**

Hoppy Bundles automatically detects the language your customer is browsing in (the storefront locale) and shows the matching translation.

* ✅ If a translation exists for the customer's language → the translated texts are shown  
* ✅ If no translation exists for that language → the original offer texts are shown instead  
* ✅ Fields left untranslated simply fall back to the original text — nothing breaks

💡 This means you can translate as many (or as few) fields as you like, and add more languages later whenever you're ready.

---

# **🎉 Final Result**

Once configured successfully:

✅ Customers see bundle offers in their own language ✅ Dynamic values like `{target}` update correctly inside translated texts ✅ Multiple storefront languages become supported ✅ Shopping experience feels more localized and personalized ✨

Using translations properly can significantly improve customer experience for international storefront visitors 🚀