> ## 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). # 🌍 Upsell & Cross Sell β€” Translation Hoppy Upsell & Cross Sell allows merchants to create translations for the customer-facing texts shown inside the Upsell Widget. This helps stores provide a more localized shopping experience for customers browsing the storefront in different languages ✨ Translations can be added for: * 🏷️ Upsell Title * πŸ›’ Upsell Button Text (Before adding to cart) * βœ… Upsell Button Text (After adding to cart) --- # **🌐 Before Adding Translations** Before translations can be added inside Hoppy Upsell & Cross Sell, the language must already exist inside your Shopify store settings. The app 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 the app. There's also a quick shortcut available inside the app: β†’ Click **β€œAdd languages in Shopify Settings to translate”** β€” it takes you directly to the Languages page in your Shopify Admin. πŸ’‘ To add a language to your Shopify store, you can follow Shopify's official guide: β†’ [Add a language to your online store](https://help.shopify.com/en/manual/international/languages#add-a-language-to-your-online-store) --- # **πŸ”€ How the Default Language Works** Your store's **primary (default) language** does not need a translation. The Upsell Widget automatically uses the base texts you configure inside the Content tab: * **Upsell Title** * **Button Text (Before adding to cart)** * **Button Text (After adding to cart)** Whenever a customer browses your storefront in the default language β€” or in any language that does not have a translation added β€” the widget simply falls back to these base texts. That means: βœ… The default language is always covered βœ… Translations are only needed for additional storefront languages βœ… Customers never see an empty or broken widget ✨ --- # **πŸ› οΈ Step 1 β€” Open Hoppy Upsell & Cross Sell** Open the **Hoppy Upsell & Cross Sell** app from your Shopify Admin. Then: β†’ Open an existing Upsell setup β†’ Or create a new Upsell setup --- # **🎯 Step 2 β€” Navigate to the Translation Section** Once the setup is opened: β†’ Make sure you are inside the **Content** tab β†’ Scroll toward the bottom of the page β†’ Locate the **Translations** section This section allows you to add translated versions of the customer-facing texts shown inside the Upsell Widget. --- # **βž• 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 the translated Upsell Title * Add the translated button texts shown to customers ⚠️ Important: If every available language already has a translation, the **Add translation** button becomes disabled. This is normal β€” it simply means all languages are already covered ✨ --- # **✍️ Step 4 β€” Configure Translation Content** Inside the Translation modal, enter the translated text you want customers to see on the storefront. The following fields can be translated: * 🏷️ **Upsell Title** β†’ the heading shown above the upsell products (supports rich text formatting) * πŸ›’ **Upsell Button Text (Before adding to cart)** β†’ the button label customers see before adding the product, such as *β€œAdd to Cart”* * βœ… **Upsell Button Text (After adding to cart)** β†’ the button label shown after the product is added, such as *β€œAdd Another”* ⚠️ Important: All translation fields are required. If any field is left empty, the translation cannot be confirmed and an error message will appear. --- ## **πŸ’‘ Example Translation** If your base setup contains the button text: **β€œAdd to Cart”** then a French translation could look like: **β€œAjouter au panier”** Customers browsing your storefront in French will now see the French button text, while everyone else continues to see your base text ✨ --- # **✏️ Editing or Deleting a Translation** Once a translation is added, it appears as a list inside the Translations section. β†’ Click the **β‹― (menu)** icon next to a translation From here, you can: * **Edit translation** β†’ update the translated texts for that language * **Delete** β†’ remove the translation completely ⚠️ Important: Deleting a translation cannot be undone. Once deleted, customers browsing in that language will see the base texts from the Content tab again. --- # **βœ… Step 5 β€” Save & Publish** Once the translations are added: β†’ Click **Confirm translation** inside the modal β†’ Save the setup using the Save bar β†’ Publish the Upsell After publishing, customers browsing your storefront in the selected language will automatically see the translated Upsell Widget texts. The widget detects the language the customer is currently browsing in and shows the matching translation β€” no extra setup needed 🌍 --- # **πŸŽ‰ Final Result** Once configured successfully: βœ… Customers see translated Upsell titles and button texts βœ… The widget automatically matches the customer's browsing language βœ… Languages without a translation fall back to the default texts βœ… Shopping experience feels more localized and personalized ✨ Using translations properly can significantly improve the shopping experience for international storefront visitors πŸš€ --- # **πŸ›Ÿ Troubleshooting** ### **A language is missing from the translation dropdown** β†’ Make sure the language is added in **Shopify Admin β†’ Settings β†’ Languages** first. Only languages configured there become available inside the app. ### **The Add translation button is disabled** β†’ This happens when every available language already has a translation. Edit an existing translation instead, or add more languages in Shopify Settings. ### **Customers still see the default texts** β†’ Check that a translation exists for the exact language the customer is browsing in. If no translation matches, the widget always falls back to the base texts from the Content tab. β†’ Also make sure the setup was **Saved and Published** after adding the translation.