Product Integration (Shopify)

This page provides an overview of how product integration via API works on Shopify, highlighting key concepts and important points to consider.

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

Field

Sizebay Key

Shopify Source

Notes

Product Name

name

title

—

Gender

gender

name / tags

Custom mapping rule

Permalink

permalink

domain/id

Uses Shopify product ID

Product Image

image

images[0]

Primary image

Product ID

feedProductId

id

Native Shopify numeric ID

Brand Name

brandName

vendor

—

Category

categoryName

product_type

Must be mapped to Sizebay categories

Sizes

sizes

option 1/2/3

Position configured during onboarding

Age Group

ageGroup

name / tags

Custom mapping rule

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

  1. Category

Read from product_type. Must be mapped to a Sizebay category:

Sizebay Category

Common Store Examples

Top

T-shirts, shirts, jackets, blouses, sweaters, hoodies

Bottom

Pants, shorts, skirts, leggings

Full Body

Dresses, jumpsuits, overalls, rompers

Top Underwear

Bras, bralettes, crop tops (underwear)

Bottom Underwear

Briefs, boxers, panties, thongs

Shoe

Sneakers, boots, sandals, heels, flats

circle-exclamation

  1. Sizes

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

circle-exclamation

  1. 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:

  • Tag Assignment Tags should be added during product registration in Shopify, as described in the Shopify Help Centerarrow-up-right. 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.

circle-info

Questions? Contact your onboarding manager — we’re happy to help.

Last updated