<- Object

Object

All versions ->

CatalogItem

An CatalogObject instance of the ITEM type, also referred to as an item, in the catalog.

Link to section

Properties

Link to section

name

string

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

Link to section

description

string

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

Link to section

abbreviation

string

The text of the item's display label in the Square Point of Sale app. Only up to the first five characters of the string are used. This attribute is searchable, and its value length is of Unicode code points.

Link to section

label_color

string

The color of the item's display label in the Square Point of Sale app. This must be a valid hex color code.

Link to section

available_online

boolean

If true, the item can be added to shipping orders from the merchant's online store.

Link to section

available_for_pickup

boolean

If true, the item can be added to pickup orders from the merchant's online store.

Link to section

available_electronically

boolean

If true, the item can be added to electronically fulfilled orders from the merchant's online store.

Link to section

category_id

string

The ID of the item's category, if any.

Link to section

tax_ids

string [ ]

A set of IDs indicating the taxes enabled for this item. When updating an item, any taxes listed here will be added to the item. Taxes may also be added to or deleted from an item using UpdateItemTaxes.

Link to section

modifier_list_info

A set of CatalogItemModifierListInfo objects representing the modifier lists that apply to this item, along with the overrides and min and max limits that are specific to this item. Modifier lists may also be added to or deleted from an item using UpdateItemModifierLists.

Link to section

variations

A list of CatalogObjects containing the CatalogItemVariations for this item.

Link to section

product_type

string

The product type of the item. May not be changed once an item has been created.

Only items of product type REGULAR or APPOINTMENTS_SERVICE may be created by this API; items with other product types are read-only.

Link to section

skip_modifier_screen

boolean

If false, the Square Point of Sale app will present the CatalogItem's details screen immediately, allowing the merchant to choose CatalogModifiers before adding the item to the cart. This is the default behavior.

If true, the Square Point of Sale app will immediately add the item to the cart with the pre-selected modifiers, and merchants can edit modifiers by drilling down onto the item's details.

Third-party clients are encouraged to implement similar behaviors.

Link to section

item_options

Beta

List of item options IDs for this item. Used to manage and group item variations in a specified order.

Maximum: 6 item options.