<- Object

Object

All versions ->

CatalogItemVariation

An item variation (i.e., product) in the Catalog object model.

Each item may have a maximum of 250 item variations.

Link to section

Properties

Link to section

item_id

string

The ID of the CatalogItem associated with this item variation.

Link to section

name

string

The item variation's name. This is a searchable attribute for use in applicable query filters, and its value length is of Unicode code points.

Link to section

sku

string

The item variation's SKU, if any. This is a searchable attribute for use in applicable query filters.

Link to section

upc

string

The item variation's UPC, if any. This is a searchable attribute for use in applicable query filters. It is only accessible through the Square API, and not exposed in the Square Seller Dashboard, Square Point of Sale or Retail Point of Sale apps.

Link to section

ordinal

integer(32-bit)

Read only The order in which this item variation should be displayed. This value is read-only. On writes, the ordinal for each item variation within a parent CatalogItem is set according to the item variations's position. On reads, the value is not guaranteed to be sequential or unique.

Link to section

pricing_type

string

Indicates whether the item variation's price is fixed or determined at the time of sale.

Link to section

price_money

The item variation's price, if fixed pricing is used.

Link to section

location_overrides

Per-location price and inventory overrides.

Link to section

track_inventory

boolean

If true, inventory tracking is active for the variation.

Link to section

inventory_alert_type

string

Indicates whether the item variation displays an alert when its inventory quantity is less than or equal to its inventory_alert_threshold.

Link to section

inventory_alert_threshold

integer(64-bit)

If the inventory quantity for the variation is less than or equal to this value and inventory_alert_type is LOW_QUANTITY, the variation displays an alert in the merchant dashboard.

This value is always an integer.

Link to section

user_data

string

Arbitrary user metadata to associate with the item variation. This attribute value length is of Unicode code points.

Link to section

service_duration

integer(64-bit)

If the CatalogItem that owns this item variation is of type APPOINTMENTS_SERVICE, then this is the duration of the service in milliseconds. For example, a 30 minute appointment would have the value 1800000, which is equal to 30 (minutes) * 60 (seconds per minute) * 1000 (milliseconds per second).

Link to section

item_option_values

Beta

List of item option values associated with this item variation. Listed in the same order as the item options of the parent item.

Link to section

measurement_unit_id

string

Beta

ID of the ‘CatalogMeasurementUnit’ that is used to measure the quantity sold of this item variation. If left unset, the item will be sold in whole quantities.