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

    • Apps

      • GraphQL Admin API
      • REST Admin API

    • Themes

      • Liquid
      • Ajax API

    • Custom storefronts

      • Storefront API
      • Hydrogen
      • View all
  • Log in
  • Sign up
shopify.dev docs
  • 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
    • 2023-04
    • 2023-01
    • 2022-10
    • 2022-07
    • 2022-04
    • 2022-01
    • Overview
    • Authentication
    • Access scopes
      • Overview
      • Getting updates
      • API health report
    • Global IDs
    • Rate limits
    • Search syntax
    • Response status codes
    • Idempotent requests
      • Exports and queries
      • Imports and mutations
      • GraphQL
      • REST
    • Overview
    • Getting started
    • GraphQL reference
    • REST reference
  • Partner API
  • Payments Apps API
    • Overview
        • Overview
          • Overview
            • Overview
            • Unions
            • Merchandise
            • Objects
            • Attribute
            • BuyerIdentity
            • BuyerJourney
            • Cart
            • CartCost
            • CartDeliveryGroup
            • CartDeliveryOption
            • CartLine
            • CartLineCost
            • Company
            • CompanyContact
            • CompanyLocation
            • Country
            • Customer
            • CustomProduct
            • DeliverableCartLine
            • GateConfiguration
            • GateSubject
            • Language
            • Localization
            • MailingAddress
            • Market
            • MarketRegionCountry
            • Metafield
            • MoneyV2
            • Product
            • ProductVariant
            • PurchasingCompany
            • Interfaces
            • HasGates
            • HasMetafields
            • MarketRegion
            • Enums
            • BuyerJourneyStep
            • CountryCode
            • CurrencyCode
            • DeliveryMethod
            • LanguageCode
            • WeightUnit
          • FunctionResult
          • Input
          • Scalars
        • Overview
          • Overview
            • Overview
            • Unions
            • Merchandise
            • Objects
            • Attribute
            • BuyerIdentity
            • Cart
            • CartCost
            • CartDeliveryGroup
            • CartDeliveryOption
            • CartLine
            • CartLineCost
            • CartLineInput
            • CartOperation
            • Company
            • CompanyContact
            • CompanyLocation
            • Customer
            • CustomProduct
            • DeliverableCartLine
            • ExpandedItem
            • ExpandOperation
            • GateConfiguration
            • GateSubject
            • ImageInput
            • MailingAddress
            • MergeOperation
            • Metafield
            • MoneyV2
            • PriceAdjustment
            • PriceAdjustmentValue
            • Product
            • ProductVariant
            • PurchasingCompany
            • Interfaces
            • HasGates
            • HasMetafields
            • Enums
            • CountryCode
            • CurrencyCode
            • DeliveryMethod
            • WeightUnit
          • FunctionResult
          • Input
          • Scalars
        • Overview
          • Overview
            • Overview
            • Unions
            • Merchandise
            • Objects
            • Attribute
            • BuyerIdentity
            • Cart
            • CartCost
            • CartDeliveryGroup
            • CartDeliveryOption
            • CartLine
            • CartLineCost
            • Company
            • CompanyContact
            • CompanyLocation
            • Country
            • Customer
            • CustomProduct
            • DeliverableCartLine
            • DeliveryCustomization
            • GateConfiguration
            • GateSubject
            • HideOperation
            • Language
            • Localization
            • MailingAddress
            • Market
            • MarketRegionCountry
            • Metafield
            • MoneyV2
            • MoveOperation
            • Operation
            • Product
            • ProductVariant
            • PurchasingCompany
            • RenameOperation
            • Interfaces
            • HasGates
            • HasMetafields
            • MarketRegion
            • Enums
            • CountryCode
            • CurrencyCode
            • DeliveryMethod
            • LanguageCode
            • WeightUnit
          • FunctionResult
          • Input
          • Scalars
          • Overview
            • Overview
              • Overview
              • Unions
              • Merchandise
              • Objects
              • Attribute
              • BuyerIdentity
              • Cart
              • CartCost
              • CartDeliveryGroup
              • CartDeliveryOption
              • CartLine
              • CartLineCost
              • Company
              • CompanyContact
              • CompanyLocation
              • Condition
              • Country
              • Customer
              • CustomProduct
              • DeliverableCartLine
              • Discount
              • DiscountNode
              • FixedAmount
              • GateConfiguration
              • GateSubject
              • Language
              • Localization
              • MailingAddress
              • Market
              • MarketRegionCountry
              • Metafield
              • MoneyV2
              • OrderMinimumSubtotal
              • OrderSubtotalTarget
              • Percentage
              • Product
              • ProductMinimumQuantity
              • ProductMinimumSubtotal
              • ProductVariant
              • ProductVariantTarget
              • PurchasingCompany
              • Target
              • Value
              • Interfaces
              • HasGates
              • HasMetafields
              • MarketRegion
              • 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
              • Company
              • CompanyContact
              • CompanyLocation
              • Country
              • Customer
              • CustomProduct
              • DeliverableCartLine
              • Discount
              • DiscountNode
              • FixedAmount
              • GateConfiguration
              • GateSubject
              • Language
              • Localization
              • MailingAddress
              • Market
              • MarketRegionCountry
              • Metafield
              • MoneyV2
              • Percentage
              • Product
              • ProductVariant
              • ProductVariantTarget
              • PurchasingCompany
              • Target
              • Value
              • Interfaces
              • HasGates
              • HasMetafields
              • MarketRegion
              • Enums
              • CountryCode
              • CurrencyCode
              • DeliveryMethod
              • DiscountApplicationStrategy
              • LanguageCode
              • WeightUnit
            • FunctionResult
            • Input
            • Scalars
          • Overview
            • Overview
              • Overview
              • Unions
              • Merchandise
              • Objects
              • Attribute
              • BuyerIdentity
              • Cart
              • CartCost
              • CartDeliveryGroup
              • CartDeliveryOption
              • CartLine
              • CartLineCost
              • Company
              • CompanyContact
              • CompanyLocation
              • Country
              • Customer
              • CustomProduct
              • DeliverableCartLine
              • DeliveryGroupTarget
              • Discount
              • DiscountNode
              • FixedAmount
              • GateConfiguration
              • GateSubject
              • Language
              • Localization
              • MailingAddress
              • Market
              • MarketRegionCountry
              • Metafield
              • MoneyV2
              • Percentage
              • Product
              • ProductVariant
              • PurchasingCompany
              • Target
              • Value
              • Interfaces
              • HasGates
              • HasMetafields
              • MarketRegion
              • Enums
              • CountryCode
              • CurrencyCode
              • DeliveryMethod
              • DiscountApplicationStrategy
              • LanguageCode
              • WeightUnit
            • FunctionResult
            • Input
            • Scalars
        • Overview
          • Overview
            • Overview
            • Unions
            • Merchandise
            • Objects
            • Attribute
            • BuyerIdentity
            • Cart
            • CartCost
            • CartDeliveryGroup
            • CartDeliveryOption
            • CartLine
            • CartLineCost
            • Company
            • CompanyContact
            • CompanyLocation
            • Customer
            • CustomProduct
            • DeliverableCartLine
            • FulfillmentConstraintRule
            • GateConfiguration
            • GateSubject
            • Location
            • LocationAddress
            • MailingAddress
            • Metafield
            • MoneyV2
            • MustFulfillFrom
            • MustFulfillFromSameLocation
            • Operation
            • Product
            • ProductVariant
            • PurchasingCompany
            • Interfaces
            • HasGates
            • HasMetafields
            • Enums
            • CountryCode
            • CurrencyCode
            • DeliveryMethod
            • WeightUnit
          • FunctionResult
          • Input
          • Scalars
        • Overview
          • Overview
            • Overview
            • Unions
            • Merchandise
            • Objects
            • Attribute
            • BuyerIdentity
            • Cart
            • CartCost
            • CartDeliveryGroup
            • CartDeliveryOption
            • CartLine
            • CartLineCost
            • Company
            • CompanyContact
            • CompanyLocation
            • Country
            • Customer
            • CustomProduct
            • DeliverableCartLine
            • FulfillmentGroup
            • FulfillmentGroupRankedLocations
            • GateConfiguration
            • GateSubject
            • InventoryLocation
            • Location
            • LocationAddress
            • MailingAddress
            • Market
            • Metafield
            • MoneyV2
            • Operation
            • OrderRoutingLocationRule
            • Product
            • ProductVariant
            • PurchasingCompany
            • RankedLocation
            • Interfaces
            • HasGates
            • HasMetafields
            • Region
            • Enums
            • CountryCode
            • CurrencyCode
            • DeliveryMethod
            • WeightUnit
          • FunctionResult
          • Input
          • Scalars
        • Overview
          • Overview
            • Overview
            • Unions
            • Merchandise
            • Objects
            • Attribute
            • BuyerIdentity
            • Cart
            • CartCost
            • CartDeliveryGroup
            • CartDeliveryOption
            • CartLine
            • CartLineCost
            • Company
            • CompanyContact
            • CompanyLocation
            • Country
            • Customer
            • CustomProduct
            • DeliverableCartLine
            • GateConfiguration
            • GateSubject
            • HideOperation
            • Language
            • Localization
            • MailingAddress
            • Market
            • MarketRegionCountry
            • Metafield
            • MoneyV2
            • MoveOperation
            • Operation
            • PaymentCustomization
            • PaymentCustomizationPaymentMethod
            • Product
            • ProductVariant
            • PurchasingCompany
            • RenameOperation
            • Interfaces
            • HasGates
            • HasMetafields
            • MarketRegion
            • Enums
            • CountryCode
            • CurrencyCode
            • DeliveryMethod
            • LanguageCode
            • WeightUnit
          • FunctionResult
          • Input
          • Scalars
    • Settings
    • Error handling
    • Overview
      • ActiveDatesCard
      • AppProvider
      • CombinationCard
      • CountriesAndRatesCard
      • CustomerEligibilityCard
      • MethodCard
      • MinimumRequirementsCard
      • PurchaseTypeCard
      • SummaryCard
      • UsageLimitsCard
    • Overview
          • deprecated
          • include
          • skip
        • Scalars
        • Overview
        • Queries
        • productLookup
        • Objects
        • MarketplaceNode
        • ProductLookupResults
        • ProductShopResult
    • Overview
    • Reference
  • Multipass
    • Overview
    • ShopifyQL reference
    • Segment query language reference
      • Inventory dataset
      • Orders dataset
      • Products dataset
      • Benchmark dataset
    • Overview
      • Connect wallet
      • Tokengate
    • Theming
  • Liquid
    • Overview
      • Cart
      • Product
      • Product recommendations
      • Predictive search
  • Section Rendering API
  • Customer Privacy API
  • Storefront API
  • Hydrogen
  • Hydrogen React
    • 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
    • Checkout UI
      • Overview
      • Configuration
      • Extension points API
      • Components
      • JWT specification
    • Overview
    • Cart extension reference
    • Product recommendations reference
    • Overview
    • Customer events reference
    • Web pixel extension API
    • Overview
    • Components
    • Endpoints
    • Statuses
  • 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
    • 2023-04
    • 2023-01
    • 2022-10
    • 2022-07
    • 2022-04
    • 2022-01
    • Overview
    • Authentication
    • Access scopes
      • Overview
      • Getting updates
      • API health report
    • Global IDs
    • Rate limits
    • Search syntax
    • Response status codes
    • Idempotent requests
      • Exports and queries
      • Imports and mutations
      • GraphQL
      • REST
    • Overview
    • Getting started
    • GraphQL reference
    • REST reference
  • Partner API
  • Payments Apps API
    • Overview
        • Overview
          • Overview
            • Overview
            • Unions
            • Merchandise
            • Objects
            • Attribute
            • BuyerIdentity
            • BuyerJourney
            • Cart
            • CartCost
            • CartDeliveryGroup
            • CartDeliveryOption
            • CartLine
            • CartLineCost
            • Company
            • CompanyContact
            • CompanyLocation
            • Country
            • Customer
            • CustomProduct
            • DeliverableCartLine
            • GateConfiguration
            • GateSubject
            • Language
            • Localization
            • MailingAddress
            • Market
            • MarketRegionCountry
            • Metafield
            • MoneyV2
            • Product
            • ProductVariant
            • PurchasingCompany
            • Interfaces
            • HasGates
            • HasMetafields
            • MarketRegion
            • Enums
            • BuyerJourneyStep
            • CountryCode
            • CurrencyCode
            • DeliveryMethod
            • LanguageCode
            • WeightUnit
          • FunctionResult
          • Input
          • Scalars
        • Overview
          • Overview
            • Overview
            • Unions
            • Merchandise
            • Objects
            • Attribute
            • BuyerIdentity
            • Cart
            • CartCost
            • CartDeliveryGroup
            • CartDeliveryOption
            • CartLine
            • CartLineCost
            • CartLineInput
            • CartOperation
            • Company
            • CompanyContact
            • CompanyLocation
            • Customer
            • CustomProduct
            • DeliverableCartLine
            • ExpandedItem
            • ExpandOperation
            • GateConfiguration
            • GateSubject
            • ImageInput
            • MailingAddress
            • MergeOperation
            • Metafield
            • MoneyV2
            • PriceAdjustment
            • PriceAdjustmentValue
            • Product
            • ProductVariant
            • PurchasingCompany
            • Interfaces
            • HasGates
            • HasMetafields
            • Enums
            • CountryCode
            • CurrencyCode
            • DeliveryMethod
            • WeightUnit
          • FunctionResult
          • Input
          • Scalars
        • Overview
          • Overview
            • Overview
            • Unions
            • Merchandise
            • Objects
            • Attribute
            • BuyerIdentity
            • Cart
            • CartCost
            • CartDeliveryGroup
            • CartDeliveryOption
            • CartLine
            • CartLineCost
            • Company
            • CompanyContact
            • CompanyLocation
            • Country
            • Customer
            • CustomProduct
            • DeliverableCartLine
            • DeliveryCustomization
            • GateConfiguration
            • GateSubject
            • HideOperation
            • Language
            • Localization
            • MailingAddress
            • Market
            • MarketRegionCountry
            • Metafield
            • MoneyV2
            • MoveOperation
            • Operation
            • Product
            • ProductVariant
            • PurchasingCompany
            • RenameOperation
            • Interfaces
            • HasGates
            • HasMetafields
            • MarketRegion
            • Enums
            • CountryCode
            • CurrencyCode
            • DeliveryMethod
            • LanguageCode
            • WeightUnit
          • FunctionResult
          • Input
          • Scalars
          • Overview
            • Overview
              • Overview
              • Unions
              • Merchandise
              • Objects
              • Attribute
              • BuyerIdentity
              • Cart
              • CartCost
              • CartDeliveryGroup
              • CartDeliveryOption
              • CartLine
              • CartLineCost
              • Company
              • CompanyContact
              • CompanyLocation
              • Condition
              • Country
              • Customer
              • CustomProduct
              • DeliverableCartLine
              • Discount
              • DiscountNode
              • FixedAmount
              • GateConfiguration
              • GateSubject
              • Language
              • Localization
              • MailingAddress
              • Market
              • MarketRegionCountry
              • Metafield
              • MoneyV2
              • OrderMinimumSubtotal
              • OrderSubtotalTarget
              • Percentage
              • Product
              • ProductMinimumQuantity
              • ProductMinimumSubtotal
              • ProductVariant
              • ProductVariantTarget
              • PurchasingCompany
              • Target
              • Value
              • Interfaces
              • HasGates
              • HasMetafields
              • MarketRegion
              • 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
              • Company
              • CompanyContact
              • CompanyLocation
              • Country
              • Customer
              • CustomProduct
              • DeliverableCartLine
              • Discount
              • DiscountNode
              • FixedAmount
              • GateConfiguration
              • GateSubject
              • Language
              • Localization
              • MailingAddress
              • Market
              • MarketRegionCountry
              • Metafield
              • MoneyV2
              • Percentage
              • Product
              • ProductVariant
              • ProductVariantTarget
              • PurchasingCompany
              • Target
              • Value
              • Interfaces
              • HasGates
              • HasMetafields
              • MarketRegion
              • Enums
              • CountryCode
              • CurrencyCode
              • DeliveryMethod
              • DiscountApplicationStrategy
              • LanguageCode
              • WeightUnit
            • FunctionResult
            • Input
            • Scalars
          • Overview
            • Overview
              • Overview
              • Unions
              • Merchandise
              • Objects
              • Attribute
              • BuyerIdentity
              • Cart
              • CartCost
              • CartDeliveryGroup
              • CartDeliveryOption
              • CartLine
              • CartLineCost
              • Company
              • CompanyContact
              • CompanyLocation
              • Country
              • Customer
              • CustomProduct
              • DeliverableCartLine
              • DeliveryGroupTarget
              • Discount
              • DiscountNode
              • FixedAmount
              • GateConfiguration
              • GateSubject
              • Language
              • Localization
              • MailingAddress
              • Market
              • MarketRegionCountry
              • Metafield
              • MoneyV2
              • Percentage
              • Product
              • ProductVariant
              • PurchasingCompany
              • Target
              • Value
              • Interfaces
              • HasGates
              • HasMetafields
              • MarketRegion
              • Enums
              • CountryCode
              • CurrencyCode
              • DeliveryMethod
              • DiscountApplicationStrategy
              • LanguageCode
              • WeightUnit
            • FunctionResult
            • Input
            • Scalars
        • Overview
          • Overview
            • Overview
            • Unions
            • Merchandise
            • Objects
            • Attribute
            • BuyerIdentity
            • Cart
            • CartCost
            • CartDeliveryGroup
            • CartDeliveryOption
            • CartLine
            • CartLineCost
            • Company
            • CompanyContact
            • CompanyLocation
            • Customer
            • CustomProduct
            • DeliverableCartLine
            • FulfillmentConstraintRule
            • GateConfiguration
            • GateSubject
            • Location
            • LocationAddress
            • MailingAddress
            • Metafield
            • MoneyV2
            • MustFulfillFrom
            • MustFulfillFromSameLocation
            • Operation
            • Product
            • ProductVariant
            • PurchasingCompany
            • Interfaces
            • HasGates
            • HasMetafields
            • Enums
            • CountryCode
            • CurrencyCode
            • DeliveryMethod
            • WeightUnit
          • FunctionResult
          • Input
          • Scalars
        • Overview
          • Overview
            • Overview
            • Unions
            • Merchandise
            • Objects
            • Attribute
            • BuyerIdentity
            • Cart
            • CartCost
            • CartDeliveryGroup
            • CartDeliveryOption
            • CartLine
            • CartLineCost
            • Company
            • CompanyContact
            • CompanyLocation
            • Country
            • Customer
            • CustomProduct
            • DeliverableCartLine
            • FulfillmentGroup
            • FulfillmentGroupRankedLocations
            • GateConfiguration
            • GateSubject
            • InventoryLocation
            • Location
            • LocationAddress
            • MailingAddress
            • Market
            • Metafield
            • MoneyV2
            • Operation
            • OrderRoutingLocationRule
            • Product
            • ProductVariant
            • PurchasingCompany
            • RankedLocation
            • Interfaces
            • HasGates
            • HasMetafields
            • Region
            • Enums
            • CountryCode
            • CurrencyCode
            • DeliveryMethod
            • WeightUnit
          • FunctionResult
          • Input
          • Scalars
        • Overview
          • Overview
            • Overview
            • Unions
            • Merchandise
            • Objects
            • Attribute
            • BuyerIdentity
            • Cart
            • CartCost
            • CartDeliveryGroup
            • CartDeliveryOption
            • CartLine
            • CartLineCost
            • Company
            • CompanyContact
            • CompanyLocation
            • Country
            • Customer
            • CustomProduct
            • DeliverableCartLine
            • GateConfiguration
            • GateSubject
            • HideOperation
            • Language
            • Localization
            • MailingAddress
            • Market
            • MarketRegionCountry
            • Metafield
            • MoneyV2
            • MoveOperation
            • Operation
            • PaymentCustomization
            • PaymentCustomizationPaymentMethod
            • Product
            • ProductVariant
            • PurchasingCompany
            • RenameOperation
            • Interfaces
            • HasGates
            • HasMetafields
            • MarketRegion
            • Enums
            • CountryCode
            • CurrencyCode
            • DeliveryMethod
            • LanguageCode
            • WeightUnit
          • FunctionResult
          • Input
          • Scalars
    • Settings
    • Error handling
    • Overview
      • ActiveDatesCard
      • AppProvider
      • CombinationCard
      • CountriesAndRatesCard
      • CustomerEligibilityCard
      • MethodCard
      • MinimumRequirementsCard
      • PurchaseTypeCard
      • SummaryCard
      • UsageLimitsCard
    • Overview
          • deprecated
          • include
          • skip
        • Scalars
        • Overview
        • Queries
        • productLookup
        • Objects
        • MarketplaceNode
        • ProductLookupResults
        • ProductShopResult
    • Overview
    • Reference
  • Multipass
    • Overview
    • ShopifyQL reference
    • Segment query language reference
      • Inventory dataset
      • Orders dataset
      • Products dataset
      • Benchmark dataset
    • Overview
      • Connect wallet
      • Tokengate
    • Theming
  • Liquid
    • Overview
      • Cart
      • Product
      • Product recommendations
      • Predictive search
  • Section Rendering API
  • Customer Privacy API
  • Storefront API
  • Hydrogen
  • Hydrogen React
    • 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
    • Checkout UI
      • Overview
      • Configuration
      • Extension points API
      • Components
      • JWT specification
    • Overview
    • Cart extension reference
    • Product recommendations reference
    • Overview
    • Customer events reference
    • Web pixel extension API
    • Overview
    • Components
    • Endpoints
    • Statuses

Merchandise union

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

The merchandise to be purchased at checkout.

Possible types

  • CustomProduct
  • ProductVariant

Updates & News

  • Developer changelog
  • Partner blog
  • Engineering blog
  • UX blog

Community

  • Developer forum
  • Discord
  • Twitter
  • YouTube

Events

  • Unite
  • Meetups

Legal

  • Terms of Service
  • API Terms of Service
  • Privacy policy

Subscribe to receive updates from Shopify

Subscribe to receive updates from Shopify

Thanks! We’ll be in touch.

  • About Shopify
  • Shopify Plus
  • Careers
  • Investors
  • Press and Media