Product sync

When products are synced

• Full sync: reads your entire catalog (250 products per page) and sends it to Atelier Digital in batches. It runs after your store is connected, and the Atelier Digital team can run it again on request.
• Real time: when you create or update a product in Shopify, the product and all of its variants are sent again automatically.

Product deletions are not synced at the moment.

Field mapping

Each Shopify variant becomes one item in Atelier Digital.

Atelier Digital field	Shopify source
externalId	Variant ID
productExternalId	Product ID
title	Product title
brand	Product vendor
category	Mapping rules, then store default, then product type
gender	Mapping rules, then store default (male, female or unisex)
ageGroup	Mapping rules, then store default (adult or kids)
sizing	The variant’s “Size” option (or “Tamanho”), otherwise the first option
price / currency	Variant price / your store currency
imageUrl	Variant image, otherwise the first product image
productUrl	https://your-store-domain/products/{handle}

We use Shopify IDs instead of SKUs, so you don’t need any SKU convention.

Mapping rules

Shopify has no standard fields for gender, age group or category, so Atelier Digital derives them using ordered rules set up for your store. Each rule checks one of these sources:

• a product tag
• the product type
• the vendor
• the title

A rule matches when the source contains or equals a value, and returns the value to use. The first matching rule wins. If none matches, your store’s default is used.

For example: if a product has the tag women, set gender to female.

To change your rules, contact the Atelier Digital team. Tagging products consistently in Shopify makes this much easier.

Shopify Product Bundles

Bundles created with Shopify’s official Product Bundles feature are skipped by default, since they are not purchasable items on their own. Contact us if you want them included.