Update your API version to avoid issues with modifiers
If you use Catalog API to read and display items with modifiers, please update to API version 2025-05-21 or later to avoid issues with modifier selection.
What’s happening?
Square is rolling out updates to how sellers can create and customize modifiers in Square Dashboard. This includes the ability to select multiple quantities of a single modifier (e.g. coffee with 2 pumps of vanilla syrup). To support these changes, we recently made updates to the CatalogModiferList , CatalogItemModiferListInfo and CatalogModifierOverride objects in the Catalog API.
What to do?
To avoid issues with reading and display modifiers:
→ Update your application to use API version 2025-05-21 or later
→ Review the updated documentation for CatalogModiferList , CatalogItemModiferListInfo and CatalogModifierOverride
→ Ensure you are properly handling new and updated fields, including: allow_quantities , min_selected_modifiers , max_selected_modifiers , and hidden_from_customer (note: selection_type is deprecated)
Relevant Docs
2025-05-21 Changelog
CatalogItemModifierListInfo
CatalogModifierList
CatalogModifierOverride
Enable Item Customization with Modifiers