Uploaded August 2020 | Updated September 2026, 1 hour ago

---

Custom attributes let you associate additional information to ITEM and ITEM_VARIATION type catalog objects. For example, suppose a quick-service restaurant hires an order-ahead manager. The order-ahead partner needs additional information for each menu item. For example:

- A buyer-facing name such as "Chicken" instead of "CHK".
- A partner-specific price.
- Allergen information.

You can add a custom attribute to any CatalogItem object in the restaurant catalog so the merchant can add those additional details.

Seller-visible custom attributes appear within the Item Library and Service Library on the Square Dashboard, allowing merchants to leverage Square as a one-stop shop for managing their information.

Add Custom Attributes Guide – developer.squareup.com/docs/catalog-api/add-custom-attributes

Square Developer Forums – developer.squareup.com/forums
Square Developer Community – https://squ.re/slack
Square Developer Twitter – twitter.com/squaredev
Square Developer Blog – developer.squareup.com/blog