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

# 🌍 PopUps — Translation

Want your popups to feel native for every customer, no matter what language they browse in? 🌐

Hoppy PopUps lets you add translations for all the customer-facing text in your popups. Once configured, visitors browsing your storefront in different languages will automatically see the translated versions of your messages.

This guide walks through the full translation setup from start to finish.

---

# **🌐 Before You Begin**

Before you can add translations inside Hoppy PopUps, the language must already exist in your Shopify store settings.

The app automatically detects languages configured in:

→ **Shopify Admin → Settings → Languages**

Only languages added there will appear 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?” \[Link\]

---

# **🛠️ Step 1 — Open Your PopUp**

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

Then:

→ Open an existing popup setup  
→ Or create a new popup first

---

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

Once inside your popup setup:

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

This is where you add and manage all translated versions of your popup content.

---

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

Inside the Translations section:

→ Click **Add Translation**

A modal will open showing the languages available from your Shopify store settings.

→ Select the language you want to translate into

---

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

Inside the translation modal, you can translate each customer-facing field:

* **Title** — The main heading of your popup  
* **Description** — The supporting text below the title  
* **Returning Customer Message** — Shown to shoppers who have already submitted their email or phone before  
* **Returning Customer Description** — Supporting text for returning customers  
* **New Customer Message** — Shown to first-time shoppers  
* **New Customer Description** — Supporting text for new customers  
* **Opt-In Text** — The consent checkbox label  
* **Button Text** — The call-to-action button label  
* **Button Link** — The URL the button leads to  
* **Upsell Button Text (Before Add)** — Label before an upsell item is added to cart  
* **Upsell Button Text (After Add)** — Label after an upsell item is added to cart  
* **Error Message** — Email validation error text  
* **Phone Error Message** — Phone validation error text  
* **Spin Wheel Slice Labels** — Text on individual spin-wheel segments

ℹ️ The app automatically detects whether a shopper is returning or new based on whether their email or phone already exists in your subscriber data. The matching translated message will display accordingly.

---

# **🔄 Dynamic Message Behavior**

Hoppy PopUps uses built-in conditional content rather than manual placeholders.

* **Returning Customer fields** only appear to shoppers who have already submitted their contact info in a previous session.  
* **New Customer fields** appear to everyone else.

This means you don't need to insert variables like `{customer_name}` manually. The frontend automatically swaps the message based on the shopper's history.

### **Example**

If your base title is:

> "Welcome to our store\!"

Your Spanish translation could be:

> "¡Bienvenido a nuestra tienda\!"

And your returning-customer Spanish translation could be:

> "¡Nos alegra verte de nuevo\!"

The correct version will appear automatically depending on the shopper ✨

---

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

Once all translations are configured:

→ Click **Confirm Translation** inside the modal  
→ Save the popup setup  
→ Click **Publish** to make it live

After publishing, customers browsing in the selected language will automatically see the translated popup content.

---

# **⚠️ Important Notes**

* Translations are **per-popup**. If you run multiple campaigns, each one needs its own translation setup.  
* You can **edit or delete** translations anytime by reopening the Translations section.  
* The **primary language** of your store does not need a translation entry — it uses the base content you already wrote in the Content tab.  
* If a shopper's language is not translated, the popup will fall back to the base content.  
* For **spin-wheel popups**, remember to translate each slice label and message so the entire wheel feels consistent in the target language.

---

# **🎉 Final Result**

Once configured successfully:

✅ Customers browsing in different languages see localized popup content  
✅ Returning and new shoppers see the right message automatically  
✅ Multiple storefront languages are supported per popup  
✅ Your subscriber experience feels native and personalized 🌍

---