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