Chart Editor Guide
The chart editor is where charts are built. This page is the full reference for every section of the editor. For a quick first chart, see Create your first size chart.
What do these numbers measure?
Section titled “What do these numbers measure?”Every chart declares whether its numbers describe the shopper’s body (measured with a tape) or the garment (the item itself, laid flat). The choice is required before saving — the recommender uses it:
- Body chart — numbers are matched as-is; no ease is added.
- Garment chart — measurements are eased down (−ease) and stretched (+10%) before scoring, approximating how fabric gives.
If you pick the wrong one, recommendations are off by a full step — so match it to how the numbers were actually measured.
Measurements
Section titled “Measurements”Unit system you entered — Metric (cm, kg) or Imperial (US) (in, lb). This is the system your source numbers are in. Switching after typing asks whether to convert the numbers or keep them and change only the label.
Units also belong to each column in the table — one chart can mix a cm column with a kg column:
| Unit | Column kind | Converts between |
|---|---|---|
| cm | length | cm ↔ in (and mm/ft) |
| in | length | cm ↔ in |
| mm | length | — |
| ft | length | — |
| kg | weight | kg ↔ lb |
| lb | weight | kg ↔ lb |
| None | none | never converted — text as typed |
Shoppers’ conversion experience (which system shows first, fractions vs decimals, where the unit symbol appears) is controlled on the Appearance page.
Size systems shown
Section titled “Size systems shown”Charts can carry several size systems at once — each size row has a label per system. Pick a preset or end up with a custom set:
- Alpha + US + UK + EU + JP — the full set for international apparel.
- Alpha only — XS–XL.
- US + EU — numeric only.
- Custom — any combination; the badge appears when your selection matches no preset.
Shoppers switch systems inside the chart on the storefront (no page reload) if the size-system switch feature is enabled in Appearance.
The grid is the heart of the chart:
- Size column — first column; the size label per system.
- Columns — one per measurement, each with a name and unit.
- Rows — one per size.
- Paste support — copy a range from any spreadsheet, click the first target cell, paste; the grid maps the shape automatically.
Empty cells
Section titled “Empty cells”Rows missing a value are hidden on the storefront. The editor warns with the count of empty cells — fill them in or remove the row.
Cells that can’t be scored
Section titled “Cells that can’t be scored”After saving, any cell that isn’t a measurable range (e.g. ”≈ 86” with no upper bound, or free text) is excluded from size recommendations while still displaying. A warning toast tells you how many cells were excluded — open the chart and fix the value if you want it scored.
Blocks: more than one table
Section titled “Blocks: more than one table”A chart can contain several blocks: tables, plus text, image, and divider blocks for how-to-measure content. Blocks with the same tab name group into tabs on the storefront.
- The badge Sizing marks the table the recommender scores.
- Add a second table — e.g. a “Measurement guide” tab, or a half-sizes table.
- Size recommendations use — pick which columns drive recommendations. Only columns with measurable units (cm, in, kg…) can be selected.
Styling
Section titled “Styling”Every chart uses the master template styling by default (see Appearance). Per chart you can:
- Override for this chart — change colours, fonts, and table style for this chart only.
- Use master template — drop the override and follow the master again.
The Charts list shows which charts override the master so you can spot them at a glance.
Preview
Section titled “Preview”The right panel previews the chart as shoppers will see it, using your current (unsaved) data:
- Desktop / Mobile toggle — the mobile preview shows the sticky size column while the table scrolls sideways.
- The preview reflects the measurement type — “Measurements of your body” vs “Measurements of the item”.
Test in Fit Lab
Section titled “Test in Fit Lab”From the editor’s utility bar, Test in Fit Lab opens the fit simulator — enter example shopper numbers and see how every size scores before publishing. See Fit Lab.
Manage charts
Section titled “Manage charts”From the Charts page:
| Action | What it does |
|---|---|
| Create | New blank chart |
| Import | Jump to the Import page |
| Duplicate | Copy a chart (great for similar product groups) |
| Export all | Download every chart, template, and rule as JSON — any plan, including Free |
| Search/sort | By name, last updated, products assigned, status; filter by template |
Chart status
Section titled “Chart status”| Status | Meaning |
|---|---|
| Live | Synced to your storefront metaobjects |
| Syncing | Being applied to products/metaobjects right now |
| Draft | Not yet assigned/visible anywhere |
| Needs attention | Something needs fixing (e.g. the recommender table has no columns) |
Limits
Section titled “Limits”A chart’s data can be up to 100 KB — very large multi-table charts (hundreds of rows × dozens of columns) may exceed this; split them into multiple charts if the editor warns you.