How do I add ConveyThis to Shopify?
The easiest way to translate your Shopify store is the ConveyThis app from the Shopify App Store. You install it, log in or sign up inside the app, choose your languages and activate it in your theme. There is no code to paste.
Step 1. Install the app
- In your Shopify admin, go to Apps and open the Shopify App Store.

- Search for ConveyThis and click Install.

Step 2. Sign up or log in
The app opens in your Shopify admin.
- New to ConveyThis? Enter your email address and a password. You start on the Free plan.
- Already have a ConveyThis account? Log in. You can create a new project for this store or reuse an existing one.

Step 3. Choose your languages
Choose the language your store is written in and the languages you want to translate it into.

Step 4. Activate ConveyThis in your theme
- Click Activate. The Shopify theme editor opens with ConveyThis turned on.

- Click Save in the top right corner of the theme editor.

- Go back to the app and click Check activation.

That’s it. Open your store: the language switcher appears in the bottom right corner. Choose a language to see your translated store.

What’s next?
- Change the switcher’s look and position, or edit translations: click Return to Dashboard in the app, or open your ConveyThis dashboard.
- Translate the checkout: see How do I translate the Shopify checkout?
- Translate your email notifications: see Translate your Shopify email notifications.
- Give each language its own address, like
your-store.com/es/: see Translated URLs with Sub-directory below. - Sub-domains (
es.example.com) are available for Shopify stores on the Business plan or higher. See Customize your URLs.
Translated URLs with Sub-directory
By default your store keeps one address and the language changes on the page. With Sub-directory, each language gets its own address, for example your-store.com/es/ for Spanish. Shopify serves these pages using its own languages, so you don’t add any DNS records. Sub-directory is available on the Business plan or higher.
ConveyThis copies the translations you already have into Shopify. A translated /es/ page therefore arrives translated in the page itself, which is the version search engines read.
Set it up
- In the ConveyThis app, open Settings.
- Under URL Structure, choose Sub-directory.
- Check that Current Language is your store’s default language in Shopify. Sub-directory only works when they match.
- Look at the language table below the option. It lists each language you selected with a status (see the next section).
- For a language marked Needs action, click Enable if the button is shown. Otherwise, in Shopify go to Settings > Languages, open the … menu next to the language and choose Assign to domain. Then click Check again in the app.
- Save your settings. When you save, the app asks for an optional permission to read your products. Accept it if you want your product translations copied too. Without it, products are not copied.
Changes can take a minute to appear on your store.

To check the result in Shopify, go to Settings > Languages. Every language you translate into should show Published and have your domain listed under Domains. You don’t need to click Translate there: that button opens Shopify’s own Translate & Adapt app, and ConveyThis copies its translations into Shopify itself.

What the statuses mean
| Status | What it means |
|---|---|
| Ready | The language is set up in Shopify and your translations can be copied into it. |
| Needs action | The language still needs a step in Shopify, such as enabling it, publishing it or assigning it to your domain. The table tells you which one. |
| Not supported | Shopify does not offer this language for sub-directories. Remove it from your languages or choose another URL structure. |
| Check manually | The app can’t confirm the setup, for example because your store is password protected. Follow the step shown, then click Check again. |
Shopify allows up to 20 languages per store.
How translations reach Shopify
Below the table, a line such as Translations in Shopify: 120 items, last update 5 minutes ago shows how much has been copied.
- The copy runs in the background about every 15 minutes, and right after you save your settings.
- Text that has no ConveyThis translation yet is translated on the page by the widget first. It reaches Shopify on a later run.
- Only the languages you selected in ConveyThis are copied.
Edit translations
Edit translations in your ConveyThis dashboard. If you change a value directly in Shopify that ConveyThis manages, your change is replaced the next time the copy runs.
Switch back
If you change URL Structure away from Sub-directory, ConveyThis removes the translations it put in Shopify.
Install by code instead
If you don’t want to use the app, you can add the ConveyThis code to your theme yourself.
- In your ConveyThis dashboard, click Add Domain, choose Shopify under Website platform and add your store’s domain and languages. Then use this code:
<!-- ConveyThis Script Start -->
<script src="//cdn.conveythis.com/javascript/conveythis.js?api_key=YOUR_API_KEY"></script>
<!-- ConveyThis Script End -->Replace YOUR_API_KEY with your API key. You find it on your ConveyThis dashboard under Public API key (it starts with pub_).
- In your Shopify admin, go to Online Store > Themes, click … next to your theme and choose Edit code.

- Open theme.liquid, paste the code just before the closing
</body>tag and click Save.
If you change your theme later, add the code to the new theme too. With the app, you only activate ConveyThis in the new theme.
