Skip to main content

How do I translate my JSON-LD?

Add your store information in other languages for the Store and Website JSON-LD.

Written by Julia

If your store sells in more than one language, you can add your store information in each language. TinySEO then shows the right version in the Store JSON-LD and Website JSON-LD on your storefront.

Which fields can be translated

A translation has the same store information as the "General" tab:

  • Store name (required)

  • Store description (up to 500 characters)

  • Alternate names

  • Email and Phone number

  • Address, City, State/Province, Country and Postal code

  • Latitude and Longitude

  • Store logo

  • Price range from and Price range to

Working hours and social links aren't part of a translation. They always come from the "General" tab.

The Store JSON-LD uses all of the fields above except "Alternate names". The Website JSON-LD uses the translated "Store name" and "Alternate names".

How to add a translation

  1. In TinySEO, open the JSON-LD page and go to the Translations tab.

  2. Click Add translation.

  3. Pick the language in Language locale. Each language can have one translation, so languages you've already added aren't in the list.

  4. The form starts with your "General" tab info. Change the fields that should be different in this language, for example the store name and description.

  5. Click Save.

The translation shows up in the table and goes live on your storefront right away. To change it later, click Edit. To remove it, open the dropdown next to Edit and click Delete. The language of a saved translation can't be changed, so delete it and add a new one instead.

Every field in a translation replaces the matching "General" field. If you clear a field in a translation, it's left out of the JSON-LD in that language. It doesn't fall back to the "General" value.

Auto translate the description

Next to "Store description" there's an Auto translate button. It uses AI to translate the store description from your "General" tab into the language you picked and puts it in the field, so you can check it before saving.

  • Pick a language first, the button stays disabled until you do.

  • Your "General" tab needs a saved store description.

  • The button is only there when you add a translation. When you edit one, change the description by hand.

  • The translated text is up to 500 characters and doesn't use your AI credits.

How the right language is picked

The Store JSON-LD and Website JSON-LD are added to your home page. Each time the page loads, they check which storefront language the visitor is viewing:

  • Your store's default language always uses the "General" tab info.

  • Any other language uses the translation with the matching locale, for example your French (fr) translation on your French storefront.

  • For Chinese and Portuguese, add the variant your storefront uses: zh-CN or zh-TW, pt-BR or pt-PT. A storefront that only uses zh gets the zh-TW translation, and pt gets pt-BR.

In other languages, the JSON-LD also includes the language code and the URL of that language version of your store, for example /fr.

Languages without a translation

If a visitor views a language you haven't added a translation for, the Store JSON-LD and Website JSON-LD use your "General" tab info. Nothing breaks, the info just stays in your default language.

The Product, Collection, Article and Breadcrumb JSON-LD don't use this tab. They're built from the Shopify product, collection or article on the page being viewed.

Did this answer your question?