> ## 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).

# 🌍 Free Shipping Upsell Bar — Translation

Hoppy Free Shipping allows merchants to create translations for customer-facing Free Shipping messages and reward texts.

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

Translations can be added for:

* 🎯 Goal Messages  
* 📈 Progress Messages  
* 🎉 Goal Reached Messages  
* 🚚 Free Shipping Messages  
* 🎁 Reward-related Texts

---

# **🌐 Before Adding Translations**

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

Hoppy Free Shipping 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 Free Shipping.

💡 To add a language to your Shopify store, you can follow:

→ “How to add a language in a Shopify store?”

---

# **🛠️ Step 1 — Open Hoppy Free Shipping**

Open the **Hoppy Free Shipping** app from your Shopify Admin.

Then:

→ Open an existing Free Shipping Upsell setup  
→ Or create a new Free Shipping Upsell setup

---

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

Once the setup is opened:

→ Make sure you are inside the **Goal** tab  
→ Scroll toward the bottom of the setup page  
→ Locate the **Translations** section

This section allows you to add translated versions of the customer-facing messages shown throughout the Free Shipping Bar.

---

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

Inside the Translations section:

→ Click **Add Translation**

Once clicked, a Translation modal will appear.

Inside this modal, you can:

* Select the language  
* Add translated messages  
* Configure storefront-facing translation content

---

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

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

⚠️ Important:

Do not remove dynamic variables such as:

* `{order-value}`  
* `{order-value-progress}`

These variables are required for dynamic cart progress and reward calculations to appear correctly.

---

## **💡 Example Translation**

If your base setup contains the message:

**“Free shipping for orders over {order-value}”**

then a Spanish translation could look like:

**“Envío gratuito para pedidos superiores a {order-value}”**

Notice that the variable `{order-value}`is still preserved inside the translated message.

This ensures the progress value updates dynamically on the storefront ✨

---

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

Once the translations are added:

→ Click **Confirm Translation**  
→ Save the setup  
→ Publish the Free Shipping Upsell

After publishing, customers browsing your storefront in the selected language will automatically see the translated Free Shipping messages.

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

---

# **🎉 Final Result**

Once configured successfully:

✅ Customers see translated Free Shipping messages  
✅ Goal progress updates dynamically in translated content  
✅ Multiple storefront languages become supported  
✅ Shopping experience feels more localized and personalized ✨

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