Skip to content
Documentation
Core guides

Radiant guide

Create and publish a size chart

Build from a template or from scratch, review the chart content, understand lifecycle states, and publish safely.
On this page

A size chart is the product-specific source of truth behind the storefront table and, when eligible, Smart Selector. Build it around the measurements and labels the merchant can verify—not around a generic chart that happens to look similar.

Choose how to start#

Open Size charts and choose one of the available paths:

  • From template starts with a structured example that you can adapt.
  • Create from scratch starts with an empty chart for a custom size system.

Templates reduce setup time, but their values are not automatically correct for your products. Replace example measurements, labels, fit notes, and instructions with information supplied by the brand or garment specification.

Build the content#

The editor organizes the work around Content, How to measure, and Link.

In Content, define the size labels and measurement columns. Keep ranges monotonic where appropriate and avoid mixing units inside one table. If the product variants use labels such as S, M, and L, the chart should use the same labels so the result is understandable.

In How to measure, explain where each value is taken. The guide can include the transparent mannequin illustration used by the app. Instructions should help a shopper interpret the chart without overstating precision.

In Link, connect the chart to products or catalog rules. You can also manage coverage later from Assignments.

Decide whether the chart supports Smart Selector#

Smart Selector depends on supported measurement meanings, not just on a table being present. Radiant recognizes relevant body areas from the chart structure. If the chart does not satisfy the Smart measurement contract, the storefront uses the full table instead of forcing an unreliable recommendation.

Use Smart Selector when:

  • the chart contains supported measurement columns;
  • ranges are complete enough to distinguish the available sizes;
  • the values describe the intended product and fit;
  • the recommendation can be checked against representative products.

Radiant does not expose its calculation formula, thresholds, or internal recommendation logic. Shoppers receive clear inputs and understandable results without implementation details.

Use the preview correctly#

The editor preview helps you verify hierarchy, table readability, measurement guidance, and the desktop/mobile presentation. It does not confirm that a specific product is eligible on the storefront.

For storefront acceptance, test a published product after the chart is published, assigned, and placed in the theme.

Understand chart states#

Radiant uses three lifecycle states:

  • Published — available to eligible storefront products.
  • Draft — saved for editing but not intended for live use.
  • Archived — removed from the active working set without immediately deleting it.

Available actions can include Publish, Move to draft, Duplicate, Archive, Restore, and Delete. The actions shown depend on the current state.

Publish safely#

Before selecting Publish:

  1. confirm every size label and measurement;
  2. review centimeters and inches behavior;
  3. check measurement guidance and links;
  4. verify Smart eligibility or intentional table-only behavior;
  5. review catalog assignments;
  6. save the chart and review the editor preview.

After publishing, test a representative product and then one product per important assignment rule. A chart may be correct while a broader rule points it to the wrong catalog segment.

Duplicate, archive, or delete#

Use Duplicate when a related product family needs a similar starting point but different measurements. Rename the duplicate clearly before assigning it.

Use Archive when the chart should remain recoverable but should no longer appear in the active working list. Use Delete only when the chart is no longer needed and its assignments have been reviewed.