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

# 🌍 Countdown Timer — Translations

Hoppy Countdown Timer lets you create translated versions of your countdown content so customers browsing in different languages see messaging that feels native to them.

Instead of showing the same English text to every visitor, you can localize:

* 🏷️ **Title & Subheading**  
* 🔘 **Button label**  
* ⏱️ **Timer unit labels** (days, hours, minutes, seconds)  
* 📝 **Custom end-message text**

This creates a smoother, more personalized shopping experience for international customers 🌐

---

# **🌐 Before Adding Translations**

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

Hoppy Countdown Timer automatically detects the languages configured in:

→ **Shopify Admin → Settings → Languages**

Only the **non-primary** languages configured there will become available inside the app for translation. Your store's primary language is used as the default and does not need a separate translation entry.

⚠️ **Important:**

If a language is not added in Shopify Settings first, it will not appear in the Translation section inside Hoppy Countdown Timer.

💡 To add a language to your Shopify store, click **"Add languages in Shopify Settings to translate"** inside the app, or go directly to **Shopify Admin → Settings → Languages**.

---

# **🛠️ Step 1 — Open the Countdown Timer Editor**

Open the **Hoppy Countdown Timer** app from your Shopify Admin.

Then:

→ Open an existing countdown setup  
→ Or create a new countdown setup

---

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

Once inside the countdown editor:

→ Make sure you are inside the **Content** tab  
→ Scroll down to locate the **Translations** section

ℹ️ The Translations section is **not available** for **Checkout Page** countdowns. For all other placement types — Product Page, Top/Bottom Bar, Landing Page, Cart Page and Cart Drawer— translations can be added normally.

---

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

Inside the Translations section:

→ Click **Add translation**

A modal will appear where you can select a language and enter the translated content.

---

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

Inside the translation modal, manually enter the text you want customers to see on the storefront for the selected language.

The fields available depend on the **countdown placement type** you are editing:

### **Fields available for all placements**

* **Title** — The main countdown message  
* **Custom title** — Shown when the timer ends (if end action is set to "Show custom message")  
* **Custom subheading** — Shown alongside the custom title when the timer ends

### **Fields hidden for Cart Page and Cart Drawer**

* **Subheading**  
* **Days**  
* **Hours**  
* **Minutes**  
* **Seconds**

These fields do not appear for cart-related placements because those countdowns use a simplified layout.

### **Fields shown only for Top/Bottom Bar and Landing Page**

* **Button** — The call-to-action button label

ℹ️ This field only appears if your countdown placement supports a CTA button.

---

# **🔤 Dynamic Variable — `{timer}`**

For **Cart Page** and **Checkout Page** countdowns, the title field supports a special dynamic variable:

**`{timer}`**

Use this placeholder inside the title wherever you want the live countdown digits to appear inline.

### **Example**

If your base title is:

"Complete your order within {timer} to secure your items"

Then a Spanish translation could be:

"Completa tu pedido en {timer} para asegurar tus artículos"

⚠️ **Important:** Do not remove or alter the `{timer}` variable. It is required for the live countdown to render correctly inside the message.

---

# **👀 Step 5 — Preview the Translation**

After adding translations, you can preview how the countdown looks in each language before publishing.

Above the preview pane, there is a **language dropdown** that lets you switch between:

* **English** (default / primary language)  
* Each translation you have added  
* **Add More** — quickly jump back to add another translation

Selecting a translation updates the preview instantly, so you can verify that text fits properly and looks correct inside your design.

---

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

Once your translations are configured:

→ Click **Save** to store the changes  
→ Click **Publish** to make the countdown live

⚠️ **Important:** Saving alone does not push translations to your storefront. You must publish the countdown for customers to see the localized content.

After publishing, the app automatically matches each visitor's browser language to the correct translation. If a visitor's language does not have a translation configured, the countdown falls back to the default primary language content.

---

# **✏️ Editing or Deleting a Translation**

Each saved translation appears as a row inside the Translations section with the language name displayed.

→ Click the (**⋯) menu** next to any translation  
→ Choose **Edit translation** to update the text  
→ Choose **Delete** to remove it permanently

⚠️ Deleting a translation cannot be undone. If removed, visitors in that language will see the default primary language content instead.

---

# **🎉 Final Result**

Once configured successfully:

✅ Customers see countdown text in their native storefront language  
✅ The `{timer}` placeholder updates dynamically in translated titles  
✅ Unsupported languages gracefully fall back to the default content  
✅ Multiple languages can be managed from a single countdown setup  
✅ The shopping experience feels more localized and intentional ✨

Using translations properly helps your urgency messaging land more effectively with international customers — no matter what language they shop in 🚀