Product Integration (OnPage)

Sizebay registers products from HTML pages via a lightweight JavaScript embed. When a visitor lands on a product page, the script reads and registers it in real time.

No app, API token, or client credentials required. The only installation step is adding the Sizebay embed script to your store theme.

Fields Summary

Field

How It's Read

HTML Source

Notes

Product Name

Automatic

page <title> / H1

β€”

Product Image

Automatic

First image rendered

Ensure main image is correct

URL / Permalink

Automatic

Current page URL

URL changes create a new record

Sizes

Automatic

Size selector (HTML)

Must be in initial HTML, not async

Gender

Client input

meta tag / data-attr / breadcrumb

Inform Sizebay team of source

Category

Client input

meta tag / data-attr / breadcrumb

Must be mapped to Sizebay categories

Age Group

Client input

meta tag / data-attr / breadcrumb

Only required if selling kids and products

Field Notes

  1. Sizes

The script reads size options from the size selector rendered on the product page. Sizes must be present in the initial HTML response β€” if loaded asynchronously after page render, they may not be captured.

  1. Gender

No standardized field. Sizebay defaults to unisex. Inform the Sizebay team where gender is exposed in your page HTML.

Common sources:

  • Meta tag: <meta name="gender" content="male" />

  • data- attribute: data-gender="male"

  • Breadcrumb β€” if navigation separates male and female sections.

  1. Category

Used to link products to size charts and to segment usage reports. Same extraction approaches as Gender (meta tag, data- attribute, breadcrumb).

All store categories must be mapped to a Sizebay category. Example: "Dresses" β†’ Full Body. Provide your full category list and the team will configure the mappings.

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

  1. Age Group

Defaults to adult. Only required if your store sells children's products. Common sources:

  • Meta tag: <meta name="age-group" content="kids" />

  • data- attribute: data-age-group="adult"

  • Breadcrumb β€” if navigation separates adult and kids sections.

Questions? Contact your onboarding manager β€” we’re happy to help.

Last updated