Label chip

Label chip (type: label_chip, display name “Label”). Exclusive to label-type widgets (product image overlay).

Note: “Label” here refers to the chip component of label widgets, distinct from Shopify’s product / customer tag.

When placement.auto.anchor === "label", the widget’s content must be a single label_chip item (audit-enforced)
Other anchors don’t allow label_chip
Cross-type switching is hidden-prohibited (see Widget types)

Fields

Icon (chip.icon) — icon picker (Icons / Brand / Shapes / URL)
Text (chip.text) — chip display text
Content mode (chip.contentMode): Icon only / Text only / Both (icon-only / text-only / both)
Order (chip.layout.order): Icon first / Text first
Orientation / rotation (chip.orientation) — horizontal / vertical / tilted angle

A label widget chip may have multiple instances at the same anchor (e.g. Sale + New on the same image). display.grouping controls coexistence:

Coexist mode — multiple chips display side by side (default)
Standalone mode (standalone) — chip exclusively occupies the anchor, hiding other coexisting chips
Priority — when multiple standalone chips conflict, the higher number wins; equal numbers display together (may overlap)

i18n strings:

“When multiple labels share the same anchor on an image, choose Coexist (display side by side) or Standalone (push others out).”
“When ON, this label exclusively occupies the current anchor and hides other coexisting labels.”
“When multiple standalone labels are active, the higher number wins. If equal, all display together (possibly overlapping).“

Key	Merchant-facing	Default conditions
`label-sale`	Sale	`byCompareAtPrice` enabled
`label-new` or `label-new-arrivals`	New arrivals	`byNewArrival.withinDays = 30`
`label-low-stock`	Low Stock	`byInventory.threshold` enabled
`label-natural`	Natural	No conditions, pure styling chip