---
title: Internationalization | Shopware Community Hub
description: >-
  This course covers setting up multi-language support in Shopware, including
  translating sales channels, products, and categories for a seamless localized…
canonical_url: 'https://hub.shopware.com/learn/unit/user-process-internationalization'
---

# Internationalization

<LearningObjectives>

- Understand the concept and purpose of internationalization in ecommerce.
- Configure multilingual support in Shopware using Sales Channels and subdomains.
- Apply language packs and snippet sets to localize static and dynamic content.
- Translate products, categories, and navigation elements for regional audiences.
- Set up fallback mechanisms to ensure usability when translations are missing.
- Adapt your shop to meet the language, currency, and cultural needs of international customers.

</LearningObjectives>

# Internationalization

<YoutubeEmbed link="http://youtube.com/watch?v=xHQCFP7cJIs" />

Internationalization is the action or continuous process of making our shopping experiences multilingual and region-specific within our world. By adapting content, currency, and settings, your ecommerce shop can cater to customers from different countries.

## Scenario: Address customers in their language

**Strum & Co.** is primarily designed for English-speaking users, but analytics show significant traffic from Germany, so it's time to cater to them more effectively. Translating your shop's content improves engagement and ensures a seamless customer experience.

Rather than setting up a separate shop installation, we'll use the existing one and ensure it aligns with German language and market requirements, including tax rules, delivery costs, and payment methods.

### Adding German to your Sales Channel

<ShopdevInstance plugin="lp15" step="DoNotDisplay" plan="rise" />

1. Navigate to the Sales Channel detail page  
   - In the tab **General**, scroll down to the end of the first group **General settings**, find **Languages**, and add `Deutsch` to include German in your sales channel.  

   ![Sales Channel Add Language](./assets/saleschannel2.jpg)

2. Configure a sub-domain  
   - Scroll to **Domains** and click **Add domain**.  
   - Create a new subdomain (example: `https://subdomain.hosting_url`) by only adding a suffix to the hosted domain. Set "Deutsch" as language, set currency as "Euro" and snippet as `BASE de-DE`. Shopware offers over 25 free languages via its [Language Pack](https://store.shopware.com/en/swag338126230916f/shopware-language-pack.html).

   ![Sales Channel Details](./assets/domain_settings.jpg)

3. Click **Add domain**.

   ![Sales Channel Details](./assets/subdomain.jpg)

4. Save and test the changes
   - After adding the domain, save the sales channel.  
   - Visit the storefront to see the language switch option. Toggle between English and German to confirm the setup.

   ![Sales Channel Details](./assets/saleschannel4.jpg)

### Translate content

Shopware already provides the **standard storefront and administration texts** through **snippet translations** for all supported languages. In most cases, you only need to translate your own content, such as products, categories, or landing pages.

While static content, like buttons and navigation, automatically translates via snippet sets, the product-specific text needs manual translation. Follow these steps:

1. Translate product details page
   - Open the Product detail page. Switch to **Deutsch** at the top.  
   - Translate the product description while keeping the name in English. Save the changes.  

   ![Sales Channel Details](./assets/saleschannel5.jpg)

2. Translate categories and properties
   - Use the same process for categories, manufacturers, and other properties. You can even localize landing pages.

    > Translations may take time, but Shopware provides a fallback to display English content where translations are missing, ensuring functionality.

3. Verify the translations  
   - Check the storefront to confirm the localized experience for German customers.

### Changing static text with snippets

For static text elements like "Service hotline," use the snippet system to customize and translate.  

1. **Access snippet settings**  
   - Navigate to **Settings -> Snippets**. View all snippet sets available in your shop.

   ![Sales Channel Details](./assets/snippets.jpg)

2. **Create a new snippet set**  
   - Add a new snippet set that inherits from the base (e.g., `en_US`).  
   - This ensures updates to base snippets won't overwrite your custom changes.

   ![Sales Channel Details](./assets/snippets2.jpg)

3. **Find and edit snippets**  
   - Use the search bar to locate specific text elements, such as "0180" for the Service hotline.  
   - Double-click the snippet to edit it. If HTML is involved, reference a simple HTML guide to avoid breaking the layout.

4. **Apply the new snippet set**  
   - Go to the sales channel's **Domains** tab, select the relevant domain, and assign your new snippet set. Save the domain and sales channel.

### Verify your changes  

Visit your storefront and check the updated text. With these adjustments, you have localized your shop while maintaining a fallback for untranslated elements.  

Now, your shop is ready to serve your German audience with a tailored experience!
