2026-08-19 Changelog

• Catalog API

  • Nested Modifiers (Beta): CatalogModifier.child_modifier_list_ids now exposes nested modifier lists for multi-step choices for a catalog modifier. BatchRetrieveCatalogObjects, SearchCatalogItems, and SearchCatalogObjects now expose an optional parameter include_options to include related modifier lists for requested items, variations, and modifier lists in the response. To learn more, see Manage Nested Modifiers.

• Locations API

  • Receipt fields (Beta): Location now exposes custom_receipt_text and return_policy, previously manageable only in the Square Dashboard. Read them with RetrieveLocation and ListLocations, and set or clear them with UpdateLocation. Both fields are limited to 1,000 characters.

• Payments API

  • New enum value ErrorCode.AMOUNT_TOO_LOW

• Order Calculation Guide for Japan

Learn about versioning for the Square API and SDKs.