Shopify

Connect a Shopify store and marketers can fill modules with a product’s title, price, image and link by picking it from a search.

Modular Mail uses Shopify’s public Storefront API. There’s no app to install from the Shopify App Store.

Before you start

You’ll need:

• the Owner, Admin or Developer role in Modular Mail;
• your store’s .myshopify.com address, found in your Shopify admin under Settings, then Domains;
• ideally, a Storefront access token (see below).

Get a Storefront access token

A token is optional but recommended. Without one, only products published to your Online Store can be found, and password-protected stores don’t work.

1. In your Shopify admin, install Shopify’s free Headless sales channel.
2. Create a storefront in the Headless channel.
3. Copy its public access token.

Use the public token only. Modular Mail refuses private and Admin API tokens, which should never be shared.

Connect your store

1. Go to Integrations and open the Shopify tab.
2. Enter your Store address, such as your-store.myshopify.com.
3. Paste your Storefront access token if you have one.
4. Tick the box to confirm you’re authorised to connect this store.
5. Click Check store, then Connect store.

Settings

Setting	What it does
Market	The country and language products are priced in, as shoppers in that country see them. Sets the currency and price format.
Product page address	Where product links go, with {handle} where each product’s handle goes. Change it if your shop front isn’t on Shopify, for example https://www.example.com/products/{handle}.
Show whole prices without .00	Shows £20 rather than £20.00.

Click Save after changing settings.

Images

Product images come from Shopify’s CDN, sized for email: at twice the width of the <img> in your template, up to 1,200 pixels, for sharp images on high-resolution screens.

Disconnect

Disconnecting stops marketers filling modules from the store’s products. Products already in campaigns stay as they are, since filled values are ordinary content.

Next steps

• Developers: map fields to product properties.
• Marketers: fill modules from products.

Troubleshooting

“Your store didn’t answer.” Check the store address is the .myshopify.com one, not your custom domain. If your store is password protected, add a Storefront access token.

A product can’t be found. Without a token, only products published to the Online Store channel are searchable. With a token, make sure the product is published to your Headless storefront.

Prices are in the wrong currency. Change the Market to the country your email audience shops in.