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.
Hard binding to label widget type
Section titled “Hard binding to label widget type”- When
placement.auto.anchor === "label", the widget’scontentmust be a singlelabel_chipitem (audit-enforced) - Other anchors don’t allow
label_chip - Cross-type switching is hidden-prohibited (see Widget types)
Fields
Section titled “Fields”Content
Section titled “Content”- 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
- Background — Fill (solid / gradient / pattern)
- Text color
- Border
- Radius
- Padding
- Font size
Animation
Section titled “Animation”- Slide entrance — slide-in / fade-in, derived from anchor’s outside edge
- Hover animation
v2 grouping mode
Section titled “v2 grouping mode”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).“
4 built-in presets
Section titled “4 built-in presets”| 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 |
See Quick start (Product image overlay).
Related docs
Section titled “Related docs”- Full label creation flow: Quick start (Product image overlay)
- Label-type placement / scope behavior: Widget types