Skip to content
Saleor
Esc
↑↓navigate↵open⌘Jpreview

Schema: Saleor 3.23.43Download SDLUpgrade guides

On this page

ProductVariantChannelListing Object

Represents product variant channel listing.

type ProductVariantChannelListing implements Node {
  id: ID!
  channel: Channel!
  price: Money
  costPrice: Money
  priorPrice: Money
  isAvailableForPurchase: Boolean!
  margin: Int
  preorderThreshold: PreorderThreshold @deprecated(reason: "Preorder is deprecated and will be removed. Model pre-sales with regular stock instead: create the planned quantity in a warehouse, or set `trackInventory` to false to sell without a stock limit.")
}

Interfaces

Node

Fields

id

id · ID!

The ID of the variant channel listing.

channel

channel · Channel!

The channel to which the variant listing belongs.

price

price · Money

The price of the variant.

costPrice

costPrice · Money

Cost price of the variant.

priorPrice

priorPrice · Money

Previous price of the variant in channel. Useful for providing promotion information required by customer protection laws such as EU Omnibus directive.

Warning: This field is not updated automatically. Use Channel Listings mutation to update it manually.

Added in Saleor 3.21

isAvailableForPurchase

isAvailableForPurchase · Boolean!

Determines whether the variant can be bought in this channel. When set to false, the variant behaves as if it had no listing in this channel: it is hidden from customers and cannot be added to a checkout or an order. Its prices are preserved.

Added in Saleor 3.23

margin

margin · Int

Gross margin percentage value.

Requires one of the following permissions:MANAGE_PRODUCTS

preorderThreshold

preorderThreshold · PreorderThreshold

Preorder variant data.

Used by


Schema: Saleor 3.23.43. Download SDL.

Last updated on August 24, 2026

Was this page helpful?