<- Object

Object

CatalogItem

A 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

Deprecated

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

Deprecated at 2022-07-20, this field is planned to retire in 6 months. You should migrate to use description_html to set the description of the CatalogItem instance. The description and description_html field values are kept in sync. If you try to set the both fields, the description_html text value overwrites the description value. Updates in one field are also reflected in the other, except for when you use an early version before Square API 2022-07-20 and description_html is set to blank, setting the description value to null does not nullify description_html.

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

Deprecated

The ID of the item's category, if any. Deprecated since 2023-12-13. Use CatalogItem.categories, instead.

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

Link to section

product_type

string

The product type of the item. Once set, the product_type value cannot be modified.

Items of the LEGACY_SQUARE_ONLINE_SERVICE and LEGACY_SQUARE_ONLINE_MEMBERSHIP product types can be updated but cannot be created using the API.

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

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

Maximum: 6 item options.

Link to section

image_ids

string [ ]

Beta

The IDs of images associated with this CatalogItem instance. These images will be shown to customers in Square Online Store. The first image will show up as the icon for this item in POS.

Link to section

sort_name

string

Beta

A name to sort the item by. If this name is unspecified, namely, the sort_name field is absent, the regular name field is used for sorting. Its value must not be empty.

It is currently supported for sellers of the Japanese locale only.

Link to section

categories

Beta

The list of categories.

Link to section

description_html

string

The item's description as expressed in valid HTML elements. The length of this field value, including those of HTML tags, is of Unicode points. With application query filters, the text values of the HTML elements and attributes are searchable. Invalid or unsupported HTML elements or attributes are ignored.

Supported HTML elements include:

  • a: Link. Supports linking to website URLs, email address, and telephone numbers.
  • b, strong: Bold text
  • br: Line break
  • code: Computer code
  • div: Section
  • h1-h6: Headings
  • i, em: Italics
  • li: List element
  • ol: Numbered list
  • p: Paragraph
  • ul: Bullet list
  • u: Underline

Supported HTML attributes include:

  • align: Alignment of the text content
  • href: Link destination
  • rel: Relationship between link's target and source
  • target: Place to open the linked document
Link to section

description_plaintext

string

Read only A server-generated plaintext version of the description_html field, without formatting tags.

Link to section

channels

string [ ]

Beta

A list of IDs representing channels, such as a Square Online site, where the item can be made visible or available.

Link to section

is_archived

boolean

Indicates whether this item is archived (true) or not (false).

Link to section

ecom_seo_data

Beta

The SEO data for a seller's Square Online store.

Link to section

food_and_beverage_details

The food and beverage-specific details for the FOOD_AND_BEV item.

Link to section

reporting_category

Beta

The item's reporting category.