Skip to Content
shopify.dev
  • Apps
  • Themes
  • Custom storefronts
  • Marketplaces

    • Apps

      • GraphQL Admin API
      • REST Admin API

    • Themes

      • Liquid
      • Ajax API

    • Custom storefronts

      • Storefront API
      • Hydrogen
      • View all
Press Up Down to navigate, enter to select, esc to dismiss
No search results
  • Log in
  • Sign up
shopify.dev
  • Apps
  • Themes
  • Custom storefronts
  • Marketplaces
  • APIs and references
      • GraphQL Admin API
      • REST Admin API
      • Liquid
      • Ajax API
      • Storefront API
      • Hydrogen
      • View all
  • APIs and references
    • Overview
    • Developer previews
    • 2022-07 (Release candidate)
    • 2022-04
    • 2022-01
    • 2021-10
    • 2021-07
    • 2021-04
    • Overview
    • Authentication
    • Access scopes
      • Overview
      • Getting updates
      • API health report
    • Rate limits
    • Search syntax
    • Response status codes
    • Idempotent requests
      • Exports and queries
      • Imports and mutations
      • GraphQL
      • REST
    • Overview
      • Checkout branding
      • Customer data
        • Overview
        • Querying customer segments
          • Overview
          • Compatibility and behavior
          • Apply discounts to customer saved searches
      • Discounts
      • Gift cards
        • App translations
        • Country fields
        • Online store translations
        • Shop locales
        • Events and engagements
        • SEO data
        • Order editing
        • Sales data
        • Test orders
        • Inventory
        • Media
        • Product cost
        • Status
        • Variant media
        • Delivery profiles
        • Shipping duty refunds
      • Shop
      • Uninstalling apps
      • Cart
      • Checkout
      • Customers
        • International pricing
        • Multiple currencies
        • Multiple languages
        • Querying data
        • Local pickup
        • Metafields
        • Product filtering
      • Subscriptions
    • Overview
    • Getting started
    • GraphQL reference
    • REST reference
  • Partner API
    • Overview
    • Getting started
      • Overview
        • Overview
        • Mutations
        • paymentsAppConfigure
        • Overview
        • Mutations
        • captureSessionReject
        • captureSessionResolve
        • Overview
        • QueryRoot
        • ApiVersion
        • CaptureSession
        • CaptureSessionRejectionReasonInput
        • CaptureSessionState
        • CaptureSessionStateCode
        • CaptureSessionStateRejected
        • CaptureSessionStateRejectedReason
        • CaptureSessionStateResolved
        • CaptureSessionStates
        • CaptureSessionStatus
        • CaptureSessionStatusCode
        • CaptureSessionStatusReason
        • CaptureSessionStatusReasonRejectionCode
        • PaymentsAppConfiguration
        • PaymentSession
        • PaymentSessionActionsRedirect
        • PaymentSessionNextAction
        • PaymentSessionNextActionAction
        • PaymentSessionNextActionContext
        • PaymentSessionRejectionReasonInput
        • PaymentSessionState
        • PaymentSessionStateCode
        • PaymentSessionStatePending
        • PaymentSessionStatePendingReason
        • PaymentSessionStateRejected
        • PaymentSessionStateRejectedReason
        • PaymentSessionStateResolved
        • PaymentSessionStates
        • PaymentSessionStatus
        • PaymentSessionStatusCode
        • PaymentSessionStatusReason
        • PaymentSessionStatusReasonRejectionCode
        • RefundSession
        • RefundSessionRejectionReasonInput
        • RefundSessionState
        • RefundSessionStateCode
        • RefundSessionStateRejected
        • RefundSessionStateRejectedReason
        • RefundSessionStateResolved
        • RefundSessionStates
        • RefundSessionStatus
        • RefundSessionStatusCode
        • RefundSessionStatusReason
        • RefundSessionStatusReasonRejectionCode
        • VoidSession
        • VoidSessionRejectionReasonInput
        • VoidSessionState
        • VoidSessionStateCode
        • VoidSessionStateRejected
        • VoidSessionStateRejectedReason
        • VoidSessionStateResolved
        • VoidSessionStates
        • VoidSessionStatus
        • VoidSessionStatusCode
        • VoidSessionStatusReason
        • VoidSessionStatusReasonRejectionCode
        • deprecated
        • include
        • skip
        • Overview
        • Mutations
        • paymentSessionPending
        • paymentSessionReject
        • paymentSessionResolve
        • Overview
        • Mutations
        • refundSessionReject
        • refundSessionResolve
      • Scalars
        • Overview
        • Mutations
        • voidSessionReject
        • voidSessionResolve
    • Overview
        • deprecated
        • include
        • skip
        • Objects
        • Query
        • MarketplaceNode
        • ProductLookupResults
        • ProductShopResult
      • Scalars
    • Overview
    • Reference
    • Overview
    • Input and output
      • Overview
        • Overview
          • Overview
            • Overview
            • Unions
            • Merchandise
            • Objects
            • Attribute
            • BuyerIdentity
            • Cart
            • CartCost
            • CartDeliveryGroup
            • CartDeliveryOption
            • CartLine
            • CartLineCost
            • Condition
            • Country
            • Customer
            • CustomProduct
            • Discount
            • DiscountNode
            • FixedAmount
            • Language
            • Localization
            • MailingAddress
            • Metafield
            • MoneyV2
            • OrderMinimumSubtotal
            • OrderSubtotalTarget
            • Percentage
            • Product
            • ProductMinimumQuantity
            • ProductMinimumSubtotal
            • ProductVariant
            • ProductVariantTarget
            • Target
            • Value
            • Interfaces
            • HasMetafields
            • Enums
            • CountryCode
            • CurrencyCode
            • DeliveryMethod
            • DiscountApplicationStrategy
            • LanguageCode
            • TargetType
            • WeightUnit
          • FunctionResult
          • Input
          • Scalars
        • Overview
          • Overview
            • Overview
            • Unions
            • Merchandise
            • Objects
            • Attribute
            • BuyerIdentity
            • Cart
            • CartCost
            • CartDeliveryGroup
            • CartDeliveryOption
            • CartLine
            • CartLineCost
            • Condition
            • Country
            • Customer
            • CustomProduct
            • Discount
            • DiscountNode
            • FixedAmount
            • Language
            • Localization
            • MailingAddress
            • Metafield
            • MoneyV2
            • Percentage
            • Product
            • ProductMinimumQuantity
            • ProductMinimumSubtotal
            • ProductVariant
            • ProductVariantTarget
            • Target
            • Value
            • Interfaces
            • HasMetafields
            • Enums
            • CountryCode
            • CurrencyCode
            • DeliveryMethod
            • DiscountApplicationStrategy
            • LanguageCode
            • TargetType
            • WeightUnit
          • FunctionResult
          • Input
          • Scalars
        • Overview
          • Overview
            • Overview
            • Unions
            • Merchandise
            • Objects
            • Attribute
            • BuyerIdentity
            • Cart
            • CartCost
            • CartDeliveryGroup
            • CartDeliveryOption
            • CartLine
            • CartLineCost
            • Country
            • Customer
            • CustomProduct
            • DeliveryGroupTarget
            • Discount
            • DiscountNode
            • FixedAmount
            • Language
            • Localization
            • MailingAddress
            • Metafield
            • MoneyV2
            • Percentage
            • Product
            • ProductVariant
            • Target
            • Value
            • Interfaces
            • HasMetafields
            • Enums
            • CountryCode
            • CurrencyCode
            • DeliveryMethod
            • DiscountApplicationStrategy
            • LanguageCode
            • WeightUnit
          • FunctionResult
          • Input
          • Scalars
      • WebAssembly API
    • Settings
    • Error handling
    • Development practices
    • Overview
      • ActiveDatesCard
      • AppProvider
      • CombinationCard
      • CountriesAndRatesCard
      • CustomerEligibilityCard
      • MethodCard
      • MinimumRequirementsCard
      • PurchaseTypeCard
      • SummaryCard
      • UsageLimitsCard
  • Multipass
    • Overview
    • ShopifyQL example
    • ShopifyQL reference
    • Segment query language reference
  • Liquid
    • Overview
      • Cart
      • Product
      • Product recommendations
      • Predictive search
  • Section Rendering API
  • Customer Privacy API
  • Storefront API
    • Overview
      • Overview
        • Cookie
        • CookieSessionStorage
        • FileSessionStorage
        • FileRoutes
        • Link
        • MemorySessionStorage
        • Route
        • Router
        • ShopifyAnalytics
        • ExternalVideo
        • Image
        • MediaFile
        • Metafield
        • ModelViewer
        • Money
        • Seo
        • ShopPayButton
        • Video
        • ShopifyProvider
        • ProductPrice
        • ProductOptionsProvider
        • AddToCartButton
        • BuyNowButton
        • CartCheckoutButton
        • CartCost
        • CartLineImage
        • CartLinePrice
        • CartLineProductTitle
        • CartLineProvider
        • CartLineQuantity
        • CartLineQuantityAdjustButton
        • CartLines
        • CartProvider
        • CartShopPayButton
      • Overview
        • useNavigate
        • useRequestContext
        • useRouteParams
        • useSession
        • useLoadScript
        • useMoney
        • fetchSync
        • useQuery
        • useServerProps
        • useShop
        • useShopQuery
        • useUrl
        • useProductOptions
        • useCart
        • useCartLine
        • useLocalization
      • Overview
      • flattenConnection
      • gql
      • isBrowser
      • isServer
      • log
      • parseMetafield
      • parseMetafieldValue
      • queryShop
    • Framework
    • Overview
    • Utilities
      • Overview
      • Badge
      • Banner
      • BlockStack
      • Button
      • Card
      • CardSection
      • Checkbox
      • Heading
      • Icon
      • InlineStack
      • Link
      • Modal
      • OptionList
      • Pressable
      • Radio
      • ResourceItem
      • ResourceList
      • Select
      • Spinner
      • StackItem
      • Text
      • TextBlock
      • TextField
      • Thumbnail
    • Overview
      • Overview
      • Configuration
        • Overview
        • Extension points API
        • Overview
        • Banner
        • BlockLayout
        • BlockSpacer
        • BlockStack
        • Button
        • Checkbox
        • Choice
        • ChoiceList
        • Divider
        • Form
        • Grid
        • GridItem
        • Heading
        • HeadingGroup
        • Icon
        • Image
        • InlineLayout
        • InlineSpacer
        • InlineStack
        • Link
        • List
        • ListItem
        • PhoneField
        • ScrollView
        • Select
        • SkeletonImage
        • SkeletonText
        • SkeletonTextBlock
        • Spinner
        • Stepper
        • Tag
        • Text
        • TextBlock
        • TextField
        • View
      • Overview
      • Extension points API
        • Overview
        • Banner
        • BlockStack
        • Bookend
        • Button
        • ButtonGroup
        • BuyerConsent
        • CalloutBanner
        • Checkbox
        • Form
        • FormLayout
        • Heading
        • HeadingGroup
        • HiddenForAccessibility
        • Image
        • InlineStack
        • Layout
        • Link
        • Radio
        • Select
        • Separator
        • Spinner
        • Text
        • TextBlock
        • TextContainer
        • TextField
        • Tiles
        • View
        • VisuallyHidden
      • JWT specification
    • Overview
    • Cart extension reference
    • Product recommendations reference
  • Log in
  • Sign up
Opens in a new windowOpens an external siteOpens an external site in a new window
  • APIs and references
    • Overview
    • Developer previews
    • 2022-07 (Release candidate)
    • 2022-04
    • 2022-01
    • 2021-10
    • 2021-07
    • 2021-04
    • Overview
    • Authentication
    • Access scopes
      • Overview
      • Getting updates
      • API health report
    • Rate limits
    • Search syntax
    • Response status codes
    • Idempotent requests
      • Exports and queries
      • Imports and mutations
      • GraphQL
      • REST
    • Overview
      • Checkout branding
      • Customer data
        • Overview
        • Querying customer segments
          • Overview
          • Compatibility and behavior
          • Apply discounts to customer saved searches
      • Discounts
      • Gift cards
        • App translations
        • Country fields
        • Online store translations
        • Shop locales
        • Events and engagements
        • SEO data
        • Order editing
        • Sales data
        • Test orders
        • Inventory
        • Media
        • Product cost
        • Status
        • Variant media
        • Delivery profiles
        • Shipping duty refunds
      • Shop
      • Uninstalling apps
      • Cart
      • Checkout
      • Customers
        • International pricing
        • Multiple currencies
        • Multiple languages
        • Querying data
        • Local pickup
        • Metafields
        • Product filtering
      • Subscriptions
    • Overview
    • Getting started
    • GraphQL reference
    • REST reference
  • Partner API
    • Overview
    • Getting started
      • Overview
        • Overview
        • Mutations
        • paymentsAppConfigure
        • Overview
        • Mutations
        • captureSessionReject
        • captureSessionResolve
        • Overview
        • QueryRoot
        • ApiVersion
        • CaptureSession
        • CaptureSessionRejectionReasonInput
        • CaptureSessionState
        • CaptureSessionStateCode
        • CaptureSessionStateRejected
        • CaptureSessionStateRejectedReason
        • CaptureSessionStateResolved
        • CaptureSessionStates
        • CaptureSessionStatus
        • CaptureSessionStatusCode
        • CaptureSessionStatusReason
        • CaptureSessionStatusReasonRejectionCode
        • PaymentsAppConfiguration
        • PaymentSession
        • PaymentSessionActionsRedirect
        • PaymentSessionNextAction
        • PaymentSessionNextActionAction
        • PaymentSessionNextActionContext
        • PaymentSessionRejectionReasonInput
        • PaymentSessionState
        • PaymentSessionStateCode
        • PaymentSessionStatePending
        • PaymentSessionStatePendingReason
        • PaymentSessionStateRejected
        • PaymentSessionStateRejectedReason
        • PaymentSessionStateResolved
        • PaymentSessionStates
        • PaymentSessionStatus
        • PaymentSessionStatusCode
        • PaymentSessionStatusReason
        • PaymentSessionStatusReasonRejectionCode
        • RefundSession
        • RefundSessionRejectionReasonInput
        • RefundSessionState
        • RefundSessionStateCode
        • RefundSessionStateRejected
        • RefundSessionStateRejectedReason
        • RefundSessionStateResolved
        • RefundSessionStates
        • RefundSessionStatus
        • RefundSessionStatusCode
        • RefundSessionStatusReason
        • RefundSessionStatusReasonRejectionCode
        • VoidSession
        • VoidSessionRejectionReasonInput
        • VoidSessionState
        • VoidSessionStateCode
        • VoidSessionStateRejected
        • VoidSessionStateRejectedReason
        • VoidSessionStateResolved
        • VoidSessionStates
        • VoidSessionStatus
        • VoidSessionStatusCode
        • VoidSessionStatusReason
        • VoidSessionStatusReasonRejectionCode
        • deprecated
        • include
        • skip
        • Overview
        • Mutations
        • paymentSessionPending
        • paymentSessionReject
        • paymentSessionResolve
        • Overview
        • Mutations
        • refundSessionReject
        • refundSessionResolve
      • Scalars
        • Overview
        • Mutations
        • voidSessionReject
        • voidSessionResolve
    • Overview
        • deprecated
        • include
        • skip
        • Objects
        • Query
        • MarketplaceNode
        • ProductLookupResults
        • ProductShopResult
      • Scalars
    • Overview
    • Reference
    • Overview
    • Input and output
      • Overview
        • Overview
          • Overview
            • Overview
            • Unions
            • Merchandise
            • Objects
            • Attribute
            • BuyerIdentity
            • Cart
            • CartCost
            • CartDeliveryGroup
            • CartDeliveryOption
            • CartLine
            • CartLineCost
            • Condition
            • Country
            • Customer
            • CustomProduct
            • Discount
            • DiscountNode
            • FixedAmount
            • Language
            • Localization
            • MailingAddress
            • Metafield
            • MoneyV2
            • OrderMinimumSubtotal
            • OrderSubtotalTarget
            • Percentage
            • Product
            • ProductMinimumQuantity
            • ProductMinimumSubtotal
            • ProductVariant
            • ProductVariantTarget
            • Target
            • Value
            • Interfaces
            • HasMetafields
            • Enums
            • CountryCode
            • CurrencyCode
            • DeliveryMethod
            • DiscountApplicationStrategy
            • LanguageCode
            • TargetType
            • WeightUnit
          • FunctionResult
          • Input
          • Scalars
        • Overview
          • Overview
            • Overview
            • Unions
            • Merchandise
            • Objects
            • Attribute
            • BuyerIdentity
            • Cart
            • CartCost
            • CartDeliveryGroup
            • CartDeliveryOption
            • CartLine
            • CartLineCost
            • Condition
            • Country
            • Customer
            • CustomProduct
            • Discount
            • DiscountNode
            • FixedAmount
            • Language
            • Localization
            • MailingAddress
            • Metafield
            • MoneyV2
            • Percentage
            • Product
            • ProductMinimumQuantity
            • ProductMinimumSubtotal
            • ProductVariant
            • ProductVariantTarget
            • Target
            • Value
            • Interfaces
            • HasMetafields
            • Enums
            • CountryCode
            • CurrencyCode
            • DeliveryMethod
            • DiscountApplicationStrategy
            • LanguageCode
            • TargetType
            • WeightUnit
          • FunctionResult
          • Input
          • Scalars
        • Overview
          • Overview
            • Overview
            • Unions
            • Merchandise
            • Objects
            • Attribute
            • BuyerIdentity
            • Cart
            • CartCost
            • CartDeliveryGroup
            • CartDeliveryOption
            • CartLine
            • CartLineCost
            • Country
            • Customer
            • CustomProduct
            • DeliveryGroupTarget
            • Discount
            • DiscountNode
            • FixedAmount
            • Language
            • Localization
            • MailingAddress
            • Metafield
            • MoneyV2
            • Percentage
            • Product
            • ProductVariant
            • Target
            • Value
            • Interfaces
            • HasMetafields
            • Enums
            • CountryCode
            • CurrencyCode
            • DeliveryMethod
            • DiscountApplicationStrategy
            • LanguageCode
            • WeightUnit
          • FunctionResult
          • Input
          • Scalars
      • WebAssembly API
    • Settings
    • Error handling
    • Development practices
    • Overview
      • ActiveDatesCard
      • AppProvider
      • CombinationCard
      • CountriesAndRatesCard
      • CustomerEligibilityCard
      • MethodCard
      • MinimumRequirementsCard
      • PurchaseTypeCard
      • SummaryCard
      • UsageLimitsCard
  • Multipass
    • Overview
    • ShopifyQL example
    • ShopifyQL reference
    • Segment query language reference
  • Liquid
    • Overview
      • Cart
      • Product
      • Product recommendations
      • Predictive search
  • Section Rendering API
  • Customer Privacy API
  • Storefront API
    • Overview
      • Overview
        • Cookie
        • CookieSessionStorage
        • FileSessionStorage
        • FileRoutes
        • Link
        • MemorySessionStorage
        • Route
        • Router
        • ShopifyAnalytics
        • ExternalVideo
        • Image
        • MediaFile
        • Metafield
        • ModelViewer
        • Money
        • Seo
        • ShopPayButton
        • Video
        • ShopifyProvider
        • ProductPrice
        • ProductOptionsProvider
        • AddToCartButton
        • BuyNowButton
        • CartCheckoutButton
        • CartCost
        • CartLineImage
        • CartLinePrice
        • CartLineProductTitle
        • CartLineProvider
        • CartLineQuantity
        • CartLineQuantityAdjustButton
        • CartLines
        • CartProvider
        • CartShopPayButton
      • Overview
        • useNavigate
        • useRequestContext
        • useRouteParams
        • useSession
        • useLoadScript
        • useMoney
        • fetchSync
        • useQuery
        • useServerProps
        • useShop
        • useShopQuery
        • useUrl
        • useProductOptions
        • useCart
        • useCartLine
        • useLocalization
      • Overview
      • flattenConnection
      • gql
      • isBrowser
      • isServer
      • log
      • parseMetafield
      • parseMetafieldValue
      • queryShop
    • Framework
    • Overview
    • Utilities
      • Overview
      • Badge
      • Banner
      • BlockStack
      • Button
      • Card
      • CardSection
      • Checkbox
      • Heading
      • Icon
      • InlineStack
      • Link
      • Modal
      • OptionList
      • Pressable
      • Radio
      • ResourceItem
      • ResourceList
      • Select
      • Spinner
      • StackItem
      • Text
      • TextBlock
      • TextField
      • Thumbnail
    • Overview
      • Overview
      • Configuration
        • Overview
        • Extension points API
        • Overview
        • Banner
        • BlockLayout
        • BlockSpacer
        • BlockStack
        • Button
        • Checkbox
        • Choice
        • ChoiceList
        • Divider
        • Form
        • Grid
        • GridItem
        • Heading
        • HeadingGroup
        • Icon
        • Image
        • InlineLayout
        • InlineSpacer
        • InlineStack
        • Link
        • List
        • ListItem
        • PhoneField
        • ScrollView
        • Select
        • SkeletonImage
        • SkeletonText
        • SkeletonTextBlock
        • Spinner
        • Stepper
        • Tag
        • Text
        • TextBlock
        • TextField
        • View
      • Overview
      • Extension points API
        • Overview
        • Banner
        • BlockStack
        • Bookend
        • Button
        • ButtonGroup
        • BuyerConsent
        • CalloutBanner
        • Checkbox
        • Form
        • FormLayout
        • Heading
        • HeadingGroup
        • HiddenForAccessibility
        • Image
        • InlineStack
        • Layout
        • Link
        • Radio
        • Select
        • Separator
        • Spinner
        • Text
        • TextBlock
        • TextContainer
        • TextField
        • Tiles
        • View
        • VisuallyHidden
      • JWT specification
    • Overview
    • Cart extension reference
    • Product recommendations reference

Merchandise union

Unstable
2022-07 Release candidate
2022-04 Latest
2022-01
2021-10
2021-07

The merchandise to be purchased at checkout.

Possible types

  • CustomProduct
  • ProductVariant
Shopify Editions

News and updates

  • Developer changelog
  • Shopify status

Blogs

  • Partner blog
  • Engineering blog
  • UX blog

Community

  • Developer forums
  • Devs Discord
  • Facebook group

Social

  • Twitch
  • YouTube
  • Twitter

Events

  • Unite
  • Meetups
  • Partner Town Hall

Legal

  • Terms of Service
  • API Terms of Service
  • Privacy policy
  • Partner program agreement
  • About Shopify
  • Shopify Plus
  • Careers
  • Investors
  • Press and Media