Metafields & metaobjects (recommended keys)

Metafields & metaobjects (recommended keys)

Last updated
October 20, 2025

Product metafields

  • Fit rating custom.fit_rating — Decimal (0.0–5.0, 2dp).
  • Fit notes scout.fit_notes — Rich text.
  • Care guide scout.care_guide — Rich text.
  • Launch ends at scout.launch_ends_at — Date & time.
  • Size chart ref scout.size_chart — Reference → Page or Metaobject.

Metaobjects

  • size_guide: title (text), image (image), table_file (file), notes (rich text), category (text).
  • lookbook_entry: hero (image), headline (text), blurb (rich text), cta_label (text), cta_url (URL), drop_date (datetime).

Binding in the editor

  • Click field → Dynamic source (database icon) → choose metafield.
  • Types must match (text↔text, image↔image, URL↔URL, datetime↔datetime).
  • Variant metafields don’t bind via dynamic source; requires custom logic.

Image & media standards (summary)

  • Products: 1:1 or 3:4; upload 2400px long side.
  • Collection hero: 2400×900.
  • Hero slideshow: 3840×1600.
  • Image-with-text: 2400×1800.
  • Blog hero: 2400×1200.
  • JPG for photos; PNG/SVG when needed. Poster images for video. Keep hero assets ≤ 700 KB.

Performance & accessibility

  • Responsive images (image_url) are automatic; still pre-compress large assets.
  • Avoid SEO/Schema apps that duplicate JSON-LD.
  • Alt text: short, literal, human-first.
  • Headings: do not restructure for “SEO tools”; Scout uses an accessible outline.
  • Check focus states, keyboard access, color contrast.

Close Modal