# 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


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
2. **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

{% 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:
* **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.

{% hint style="info" %} Questions? Contact your onboarding manager — we’re happy to help. {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.sizebay.com/size-and-fit-data-integration/product-integration-shopify.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.