424 command network
⌘ K / Ctrl K

Command hints

Quick routes
↑↓ select Enter openEsc close

Product custom property

This flexible block handles most "free text" scenarios: single-line text, textarea, character counter, or a simple checkbox acknowledgement.

Related: Need to add fees to text inputs or checkboxes? See Custom Option Fees.

Configuration steps

  1. Add Product custom property to your product form.
  2. Enter the Property key, heading, and optional description copy.
  3. Choose the input type:
    • Text: default single-line. If Auto switch to textarea is enabled and the max length is above 45 characters, the block automatically becomes a textarea.
    • Textarea: manually force multi-line input with optional placeholder and character counter.
    • Checkbox: great for agreement toggles; the label can display the upcharge amount if a fee product is attached.
  4. Set a Maximum characters and enable Show character count for text inputs if needed.
  5. (Optional) Link a fee product handle so ticking the checkbox or entering text triggers the add-on item. The price preview is shown in the heading or next to the checkbox label.
  6. Enable the conditional display options if this field should only appear after another property is filled in.

Product-specific placeholder text

You can show a different prompt on each product without creating extra templates.

  1. Create a product metafield in Settings → Custom data → Products.
  2. Use a single-line text field. The default namespace and key are custom.text_input_placeholder.
  3. Enter the desired prompt on each product, such as Enter the name to embroider.
  4. In the Product Custom Property block, confirm the Placeholder metafield namespace and Placeholder metafield key match your definition.

When the product metafield is empty, Vero uses the placeholder entered in the block settings instead.

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

  • Text inputs submit exactly what the shopper typed under your chosen key.
  • Required fields prompt customers to fill them in, and the character counter updates as they type.

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: