Skip to main content

Variant

Represents a single SKU of a product Only the variant level exists, there is no parent product.

type Variant {
barcode: String
casePack: Int
contentItemIds: [ID]
contentItems: [ProductContentItem]
createdAt: String!
deliveryMethod: VariantDeliveryMethod
demandHqId: ID!
manufacturer: String
mapPrice: Float
mpn: String
msrp: Float
optionValues: [String!]!
position: Int
price: Float
product: Product
productId: ID!
shippingDimensions: VariantShippingDimensions
sku: String
standardizedColor: VariantStandardizedColor
taxCode: String
title: String!
updatedAt: String!
updatedBy: String!
variantId: ID!
variantMetrics: VariantMetrics
variantSupplierVariant(
supplierVariantId: ID!
): VariantSupplierVariant
variantSupplierVariants(
after: String
before: String
first: Int
last: Int
): VariantSupplierVariantConnection!
weight: VariantWeight
}

Fields

Variant.barcode ● String scalar

UPC, ISBN, GTIN, etc.

Variant.casePack ● Int scalar

Quantity in one variant (i.e. 12-pack). Must be a positive integer.

Variant.contentItemIds ● [ID] list scalar

Associates contentItems with this variant

Variant.contentItems ● [ProductContentItem] list object

Get a list of productContentItems for a variant.

Requires productcontentitem/read permission on the DemandHq for the requesting identity.

Variant.createdAt ● String! non-null scalar

Variant.deliveryMethod ● VariantDeliveryMethod enum

Variant.demandHqId ● ID! non-null scalar

Variant.manufacturer ● String scalar

Often same as vendor, but not always.

Variant.mapPrice ● Float scalar

Minimum Advertised Price. Must be a positive number.

Variant.mpn ● String scalar

Manufacturer Part Number

Variant.msrp ● Float scalar

Manufacturer's Suggested Retail Price. Must be a positive number.

Variant.optionValues ● [String!]! non-null scalar

An array of the option values that make up this variant. For example, a product with a color and size option would have two option values, one for each of the color and size options, i.e. ["Red", "Small"] Must have 1-3, and it should match the number of options in the product, but there is no validation to do so. Set this to "No Option" if you don't want to use options for this product and this is the only variant. See https://docs.buildresonance.com/concepts/products/#no-option-products for more info.

Variant.position ● Int scalar

Used to determine what order the content comes out in. Positive Integers are allowed, up to 9,999,999,999, and it does not have to be unique or sequential.

Variant.price ● Float scalar

Price for the defaultCurrency, can be any positive float number value.

Variant.product ● Product object

Get the product this variant belongs to.

Requires the product/read scope on the associated DemandHq.

Variant.productId ● ID! non-null scalar

Variant.shippingDimensions ● VariantShippingDimensions object

Variant.sku ● String scalar

Stock Keeping Unit

Variant.standardizedColor ● VariantStandardizedColor enum

Variant.taxCode ● String scalar

Sales Tax Related Code, can match your chosen sales tax provider

Variant.title ● String! non-null scalar

Get the title of this variant (combo of optionValues)

Variant.updatedAt ● String! non-null scalar

Variant.updatedBy ● String! non-null scalar

Variant.variantId ● ID! non-null scalar

Variant.variantMetrics ● VariantMetrics object

Get variantMetrics for a Variant

Requires variant/read permission

Variant.variantSupplierVariant ● VariantSupplierVariant object

Get a single variantSupplierVariant for a Variant by the SupplierVariantId

Variant.variantSupplierVariant.supplierVariantId ● ID! non-null scalar

Variant.variantSupplierVariants ● VariantSupplierVariantConnection! non-null object

List all variantSupplierVariants for a Variant

Variant.variantSupplierVariants.after ● String scalar

Returns the elements in the list that come after the specified cursor.

Variant.variantSupplierVariants.before ● String scalar

Returns the elements in the list that come before the specified cursor.

Variant.variantSupplierVariants.first ● Int scalar

Returns the first n elements from the list.

Variant.variantSupplierVariants.last ● Int scalar

Returns the last n elements from the list.

Variant.weight ● VariantWeight object

Returned by

createVariant mutation ● createVariantFromSupplierVariant mutation ● updateVariant mutation ● updateVariants mutation ● variant query

Member of

Product object ● VariantConnection object ● VariantEdge object