> For the complete documentation index, see [llms.txt](https://docs.sizebay.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sizebay.com/size-and-fit-data-integration/product-integration-shopify.md).

# Product Integration (Shopify)

### Requirements

Create a Shopify app and share the generated token and client\_id with the Sizebay team. All product reads are performed via the Shopify API using those credentials.

### Fields Summary

<table data-header-hidden><thead><tr><th valign="middle"></th><th valign="middle"></th><th valign="middle"></th><th valign="middle"></th></tr></thead><tbody><tr><td valign="middle"><strong>Field</strong></td><td valign="middle"><strong>Sizebay Key</strong></td><td valign="middle"><strong>Shopify Source</strong></td><td valign="middle"><strong>Notes</strong></td></tr><tr><td valign="middle">Product Name</td><td valign="middle">name</td><td valign="middle">title</td><td valign="middle">—</td></tr><tr><td valign="middle">Gender</td><td valign="middle">gender</td><td valign="middle">name / tags</td><td valign="middle">Custom mapping rule</td></tr><tr><td valign="middle">Permalink</td><td valign="middle">permalink</td><td valign="middle">domain/id</td><td valign="middle">Uses Shopify product ID</td></tr><tr><td valign="middle">Product Image</td><td valign="middle">image</td><td valign="middle">images[0]</td><td valign="middle">Primary image</td></tr><tr><td valign="middle">Product ID</td><td valign="middle">feedProductId</td><td valign="middle">id</td><td valign="middle">Native Shopify numeric ID</td></tr><tr><td valign="middle">Brand Name</td><td valign="middle">brandName</td><td valign="middle">vendor</td><td valign="middle">—</td></tr><tr><td valign="middle">Category</td><td valign="middle">categoryName</td><td valign="middle">product_type</td><td valign="middle">Must be mapped to Sizebay categories</td></tr><tr><td valign="middle">Sizes</td><td valign="middle">sizes</td><td valign="middle">option 1/2/3</td><td valign="middle">Position configured during onboarding</td></tr><tr><td valign="middle">Age Group</td><td valign="middle">ageGroup</td><td valign="middle">name / tags</td><td valign="middle">Custom mapping rule</td></tr></tbody></table>

### Field Notes

1. **Gender**

No native field in Shopify. Defaults to unisex. Inform the Sizebay team of your strategy:

* Product name keywords (e.g., "Women's" → Female)
* Shopify tags — most reliable approach<br>

2. **Category**

Read from product\_type. Must be mapped to a Sizebay category:

<table data-header-hidden><thead><tr><th valign="middle"></th><th valign="middle"></th></tr></thead><tbody><tr><td valign="middle"><strong>Sizebay Category</strong></td><td valign="middle"><strong>Common Store Examples</strong></td></tr><tr><td valign="middle">Top</td><td valign="middle">T-shirts, shirts, jackets, blouses, sweaters, hoodies</td></tr><tr><td valign="middle">Bottom</td><td valign="middle">Pants, shorts, skirts, leggings</td></tr><tr><td valign="middle">Full Body</td><td valign="middle">Dresses, jumpsuits, overalls, rompers</td></tr><tr><td valign="middle">Top Underwear</td><td valign="middle">Bras, bralettes, crop tops (underwear)</td></tr><tr><td valign="middle">Bottom Underwear</td><td valign="middle">Briefs, boxers, panties, thongs</td></tr><tr><td valign="middle">Shoe</td><td valign="middle">Sneakers, boots, sandals, heels, flats</td></tr></tbody></table>

{% hint style="warning" %}
Correct mapping directly impacts automated size chart coverage.
{% endhint %}

3. **Sizes**

Read from option1, option2, or option3. The option position is configured once and applied globally.

{% hint style="warning" %}
Size must be in the same option position across your entire catalog. Standardize before onboarding.
{% endhint %}

4. **Age Group**

No native field in Shopify. Defaults to adult. If your store sells children's products, inform the Sizebay team:

* Product name keywords (e.g., "Kids", "Junior")
* Shopify tags

### Understanding Shopify Tags

Regarding the use of Shopify tags, please consider the following guidelines to ensure proper integration and accurate size chart mapping:<br>

* **Tag Assignment**\
  Tags should be added during product registration in Shopify, as described in the [Shopify Help Center](https://help.shopify.com/en/manual/shopify-admin/productivity-tools/using-tags). This ensures that all necessary information is available at the time of ingestion by Sizebay.
* **Naming Convention**\
  Please provide the exact text used for your tags. Tag values must match precisely with Sizebay’s internal mapping in order to be correctly interpreted (e.g., gender, age group, category).
* **Capture Timing**\
  Tags are captured only when a product is first registered in the Sizebay system. If tags are added or modified after this initial ingestion, they will **not** be updated automatically. In such cases, the product will remain associated with a default or general size chart.
* **Re-integration Process**\
  Our daily synchronization process updates only size-related information (such as new SKUs or stock changes), not tags. To update tags for products already in our system, they must be deleted and re-integrated.

<figure><img src="/files/Z6gvBRZ4Ss8OJoxcUXKK" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Questions? Contact your onboarding manager — we’re happy to help.
{% endhint %}