424 command network
⌘ K / Ctrl K

Command hints

Quick routes
↑↓ select Enter openEsc close
424 Solutions
Docs

Product custom multiselect

Use this block for checkbox lists where customers may choose more than one option. Their selections appear together under your chosen label in the cart and order.

Related: Need to add fees to specific options? See Custom Option Fees.

Configuration steps

  1. Add Product custom multiselect to the product form.
  2. Set the Line item property key and populate Options using comma, pipe, or slash separators between choices (newline-separated options are supported but separators are the most reliable format).
  3. Choose layout widths, enter optional heading/description copy, and decide whether to mark the group as required. If required, communicate how many selections are expected because Shopify can only validate that something was chosen.
  4. (Optional) Configure Charge a fee for specific options with Option name|fee-product-handle pairs. The price preview automatically appears next to the checkbox label.
  5. If you need conditionals, use the same logic controls as other blocks to show the multiselect when another property contains certain values.

Shared features

All custom option blocks share these capabilities:

  • Conditional display: Show or hide based on the value of another property using the Conditional logic settings. The block remains hidden and its inputs are disabled until the condition is met.
  • Product tag filter: Limit to products with a specific tag using the Only show when product has tag setting.
  • Width controls: Choose full or half width on tablet/desktop for easier layout mixing.
  • Fee support: When Custom Option Fees are configured, selected options add the matching charge to the cart. Read more in Custom Option Fees.

How to name properties

  • The Line item property key becomes the label in the cart and order details. Use plain text such as Patch Color or Engraving.
  • Enter only the label, such as Patch Color, in the block setting.
  • Keep property keys consistent across languages and customization steps. Contact 424 Solutions if you need help translating order labels without changing saved selections.

Customer experience

  • Customers see a checklist, and their selected options are saved with the product.
  • The resulting line item property looks like Engraving add-ons: Gold Foil, Gift Box in the cart.

Troubleshooting

  • Confirm each property has a unique key before testing. Shopify overwrites duplicate property keys with the last value submitted.
  • When fees are involved, preview the cart to ensure the correct fee product is added. Refer to Custom Option Fees for troubleshooting steps.
  • If a conditional block never appears, check that its comparison value matches the intended option. Capitalization and spaces at the beginning or end do not affect matching.

See also: