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

  1. In your Shopify admin, go to Apps and open the Shopify App Store.

Where to find the Shopify App Store in your Shopify admin

  1. Search for ConveyThis and click Install.

The ConveyThis: AI Translate app on the Shopify App Store with the Install button

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.

Sign up or log in inside the ConveyThis app

Step 3. Choose your languages

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

Choosing the store language and the languages to translate into

Step 4. Activate ConveyThis in your theme

  1. Click Activate. The Shopify theme editor opens with ConveyThis turned on.

The Activate button in the ConveyThis app

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

The Save button in the Shopify theme editor

  1. Go back to the app and click Check activation.

Check activation in the ConveyThis app

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

ConveyThis is active on the store

What’s next?

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

  1. In the ConveyThis app, open Settings.
  2. Under URL Structure, choose Sub-directory.
  3. Check that Current Language is your store’s default language in Shopify. Sub-directory only works when they match.
  4. Look at the language table below the option. It lists each language you selected with a status (see the next section).
  5. 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.
  6. 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.

The URL Structure section in the ConveyThis app with Sub-directory selected, the language table with statuses and the Translations in Shopify line

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.

Shopify Settings > Languages with English as the default language and French, German and Spanish published on the store domain

What the statuses mean

StatusWhat it means
ReadyThe language is set up in Shopify and your translations can be copied into it.
Needs actionThe 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 supportedShopify does not offer this language for sub-directories. Remove it from your languages or choose another URL structure.
Check manuallyThe 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.

  1. 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_).

  1. In your Shopify admin, go to Online Store > Themes, click … next to your theme and choose Edit code.

Edit code in the theme menu

  1. 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.