Skip to content

Quick start

This takes about five minutes. You’ll need admin access to your Shopify store.

GeoGallery can only show images to markets and languages your store already offers. Set up your markets and publish your languages in Shopify under Settings > Markets first. If a customer can’t reach the French version of your store, GeoGallery can’t show them French images.

  1. Open GeoGallery on the Shopify App Store.
  2. Click Install and approve the permissions. GeoGallery asks for one permission: to read and write products. It uses it to check your product images and to add the images you approve from AI translation.

The first time you open GeoGallery you land on the Plans page.

  • Free works on up to 3 products, with no card needed.
  • Basic and Pro work on every product and include monthly AI translation credits. Both start with a 14-day free trial.

Pick one and approve the charge in Shopify if it’s a paid plan. You can switch at any time. See Plans & billing for the details.

Plans page with the Free, Basic and Pro cards

3. Add the GeoGallery block to your product page

Section titled “3. Add the GeoGallery block to your product page”

GeoGallery is a theme app block that sits in your product page’s main section.

  1. In GeoGallery, open Home.
  2. Under Add GeoGallery to your product page, click Add block to theme. Your theme editor opens on a product page with the GeoGallery block already added.
  3. Select the block and choose Match images by: Language, Country, or Country first, then language. Not sure? See Country vs language.
  4. Click Save.

Theme editor with the GeoGallery block selected and its Match images by setting

More detail, including adding the block by hand, is in Theme setup.

  1. In Shopify, open a product that has an image you want to localize, for example shirt.jpg.
  2. Name the localized version with a two-letter code and the same rest of the filename: FR_shirt.jpg for French (Language mode) or US_shirt.jpg for the United States (Country mode).
  3. Upload it to that product’s media.

Or let GeoGallery make it: translate the image with AI.

  1. Open GeoGallery Home. The setup checklist shows which codes it found (for example FR_) and on how many products.
  2. Open the product on your storefront as that market:
    • Language: /fr/products/your-product
    • Country: /products/your-product?country=US

You should see the localized image in place of the default one. If not, see Testing your storefront and Troubleshooting.

Home setup checklist: plan active, the Add block to theme button, and the codes GeoGallery found

There’s also a setup video on the GeoGallery Home page.

We can set GeoGallery up for you at no cost. Email support@lenuslabs.com and we’ll send a Shopify collaborator request, limited to themes, products and apps, which you approve in your admin and can remove at any time. We add the block to your theme and check your product pages.