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

Correct mapping directly impacts automated size chart coverage.

1. Sizes

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

Size must be in the same option position across your entire catalog. Standardize before onboarding.

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 Center. 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.

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