Truly fine

Documentation.

Setting up and managing languages in your store

Last update:

This guide will walk you through the process of setting up and managing languages in your Shopify store using the Maranello theme. Whether you’re manually translating content, localizing images and files, or even creating custom content for specific markets, this guide will provide step-by-step instructions to help you navigate the process with ease.

Step 1: Install Shopify’s Translate & Adapt app

For this guide we’ll be using the “Shopify Translate & Adapt” app to handle all translations and localization. You can use other third party translation management apps if you wish in a similar way, but since this app is developed by Shopify we’ll use it as the example for this guide.

To install the Translate & Adapt app:

  1. Navigate to the Translate & Adapt app’s page on the Shopify app directory.
  2. Click on the button that says “Add app”
  3. Select the store that you want to install it on.
  4. Follow the instructions on the screen and finalize the installation of the app.

Step 2: Create a language

Your store will already have a language created which is used as the default one (usually English). You’ll need to create additional languages via the Shopify admin:

  1. After you’ve made sure you’ve installed the Translate & Adapt app navigate to your store’s admin.
  2. Click on “Settings” on the main menu on the left.
  3. Scroll a bit further down and click on “Languages” on the main menu on the left on the settings screen.
  4. Click on the button that says “Add language”, select the first extra language you wish to create and click on the submit button to create it.

You should see be seeing the following screen which includes your default language and the extra language you just created:

Similarly to the above, you can create as many languages as your store will need by repeating the process.

Step 3: Add translations for your content

While you’re still in the screen above after you’ve created your desired languages, click on the dropdown link that says “Translate” next to the language you want to start adding translations to:

Click on the Translate & Adapt option in the dropdown, which will take you to the app’s interface which should be showing a list of all the content types throughout your store in the selected language.

To begin translating content, click on the “Edit” button of a content type (i.e. “Products”), and then choose the item you want to translate first. For example in the screenshot below, we’ve chosen to start translating our products:

Note that the “Shopify Translate & Adapt” app offers automatic translations for your content for a maximum of 2 languages. When you click Auto-translate on your content, empty and outdated content will be translated. This will not change any translations that you have added or edited manually.

Another way to access the translation app is from within the content. For example, when you navigate to a product’s edit screen in your store’s admin, clicking on “More actions > Localize” will navigate you to the product’s translation interface:

Alternatively, you can provide translations via a CSV file. You need to export the translations CSV file in the Languages settings screen and then edit it with a spreadsheet program to fill in your translations. Then re-import it to apply the translations.

Step 4: Publish your languages

Note that while translating content the languages by default remain unpublished. While unpublished, they are not visible on your storefront.

To publish a language after you’re done translating content navigate to the Languages settings page and via the three dots menu of the language click on “Publish”:

Step 5: Enabling your languages on their respective markets

To make your languages available to your customers, you will need to activate them in the markets that you want them published. By default the languages you create will be enabled on the International Market (if it exists).

  1. Navigate to the “Markets” settings page in your store’s admin.
  2. Click on “Manage” button of the market you wish to assign a language (i.e. Spain, International, etc), or create one (i.e. if you have a Spanish translation, you can create a market for the country of Spain).
  3. Click on “Domains and languages” under “Market Settings”
  4. Make sure that under the “Languages” section the languages you wish to assign to the particular market are activated.

If they’re not activated:

  1. Navigate to the “Languages” settings page in your store’s admin.
  2. From the languages list, click on the three-dots menu of the desired language, and then click on “Assign markets“.
  3. Check the markets that you wish to assign this language to.
  4. Repeat for all languages.

Step 6: Enable the language switcher on your storefront

Maranello fully supports multi-lingual stores and comes with a language selector (and a market selector) pre-enabled. Make sure that your language switcher is enabled and visible on the header by navigating to your store’s customizer, click on the Header section, and scroll until you see the Language selector header. Make sure that the language selector is enabled.

And that should be it! You’ve successfully navigated through the process of setting up and managing languages in your Shopify store using the Maranello theme. By now, you should have a multilingual store that caters to a diverse range of customers from different linguistic backgrounds.

Can't find what you are looking for? Feel free to submit a request.