Metafields

Add custom content and promotional information to individual products using metafields — badges, marquee text, countdown timers, discount codes, and upsell links.

Badge

  • Namespace and key: custom.badge
  • Type: One, Single line text
  • Examples: Sale, Featured
  • Note: The badge text entered in this metafield is displayed when badges are enabled in Product Card Settings.

Marquee

  • Namespace and key: custom.marquee
  • Type: List, Single line text
  • Examples: Free Shipping Worldwide, Limited Time Offer, New Arrival, 20% Off This Week
  • Note: This metafield is used when the Product Marquee feature is enabled.

Discount Ending Time

  • Namespace and key: custom.discount_ending_time
  • Type: One, Date and time
  • Example: December 31, 2025, 11:59 PM
  • Use Cases: Display countdown timers, highlight limited-time promotions, and automatically hide expired offers depending on theme implementation.

Discount Code

  • Namespace and key: custom.discount_code
  • Type: One, Single line text
  • Examples: SAVE10, WELCOME20, SUMMER25
  • Note: This code can be displayed on product cards, product pages, or promotional banners depending on your theme configuration.

Discount Title

  • Namespace and key: custom.discount_tittel
  • Type: One, Single line text
  • Examples: Save 20% Today, Limited Time Offer
  • Note: This title is typically displayed alongside the discount code or countdown timer.

Upsell

  • Namespace and key: custom.upsell
  • Type: List, Product
  • Use Cases: "Goes great with" — select an existing product from your catalog to create the upsell relationship.
  • Note: Select an existing product from your catalog to create the upsell relationship.