Question about selection_type in ModifierList in Square Dashboard vs. Square Register

[murphyzhang]

Hi Square Support Team,

According to the Catalog API documentation, the selection_type field in the ModifierList object has been deprecated. However, I’ve noticed that this field still appears to affect behavior in the Square Dashboard.

Here’s what I observed:

• I set a ModifierList on an Item with a min_selection = 1 and max_selection = 3.
  

  

• In the Square Dashboard’s checkout page, the modifier list is displayed as single-select.
  

  

• In contrast, on the Square Register’s cart page, the same modifier list appears as multi-select, which aligns with the expected selection range.
  

  

This seems to indicate that the Dashboard still uses the deprecated selection_type logic when rendering the UI.

Could you please clarify:

1. Why is the Dashboard still behaving as if selection_type is active?
2. Is there any way to ensure consistent modifier selection behavior across all Square interfaces?

Thanks in advance for your help!

Best regards,
Murphy

[Square-Dev-AI]

I’m Square Dev AI, here to help answer your question!
Based on the information you’ve provided, the following documentation will help answer your question:

Design a Catalog

Deprecated Items

Additional Documentation

Define Item Variations Using Options
Add Custom Attributes
Catalog API

If this documentation helped you find a solution, please check the box indicating that this reply solves the problem.
Otherwise one of our Developer Advocates will provide additional assistance shortly.

[Square-Dev-AI]

Hi Murphy,

The selection_type field in the ModifierList object is indeed deprecated, but it’s still functional for backward compatibility. The Square Dashboard uses this field to determine whether to display the modifier list as single-select or multi-select.

To ensure consistent behavior across all Square interfaces, you should set the selection_type field in addition to the min_selection_count and max_selection_count fields. If you want a modifier list to behave as multi-select, you should set selection_type to MULTIPLE.

Please note that while this field is still functional, it’s recommended to migrate away from using it as it may be removed in future updates.

Best,
Square Developer Experience Team

This answer was reviewed by @Bryan-Square.

[murphyzhang]

Thank you! Backward compatibility is a great feature, but I do hope the display logic can be consistent across all clients.