Custom option

The Custom option block was added in v1.1.0 — Learn how to update your theme to access the latest features.

In the Product template, you can add Custom options to let customers personalize products or customize their order before updating their cart.

Your customer's entered text and selected options will appear in the cart and order details.

Custom options uses line item properties to collect and display additional information in the cart and order details. Custom options does not support add-on pricing.

Text

A text field for customers to add a single word or line.

Long text

A text field for customers to add multiple lines.

Checkbox

A single 'yes' or 'no' option.

List — Dropdown

A menu of options that requires a single choice.

List — Radio buttons

A list of buttons for options that requires a single choice.

Add custom option block


  • Under Product overview, click (+) Add block and select Custom option.

  • Use the drag-and-drop handles ⋮⋮ to re-order blocks. Click the block to start adding content.

Editing a template will change all pages that use that template.

Create and assign new templates to design different page layouts.

Add dynamic content to show page-specific content in the same template.

Set up custom option


  • Choose the type of option

  • Change the label of the option

  • Add special instructions to tell customers about the option and any requirements (e.g., a maximum of 10 words).

Click Custom option block to find settings

Setting
Description
Options

Field type

Select the type of option.

Text Default Long text Checkbox List

Field label

Enter text that names the option.

If you're using multiple custom options in a product form, then make sure the field labels are unique. Learn more about line item properties.

Default: "Your label"

Instructions

Add instructions to describe how the custom option is applied to the product.

Default: "Special instructions"

Text field


Show a text field for customers to add a message or other details to their order. Select the field type:

  • Text for single-line text

  • Long text for multiple lines of text

Click Custom option block to find settings

Setting
Description
Options

Field placeholder

Change the text that appears until the customer enters their own text.

Default: "Enter your text here"

Checkbox


Set the field type to Checkbox to give customers a 'yes' or 'no' option. The checkbox uses the Field label as the option text.

You can add multiple Custom option blocks with checkboxes to let customers select one or more options from a set of options.

Click Custom option block to find settings

Setting
Description
Options

Checked value

Enter text that will appear in the order details.

Default: "Yes"

Options list


Set the field type to List to display multiple options as a Dropdown or Radio buttons.

Click Custom option block to find settings

Setting
Description
Options

List style

Display options as a dropdown menu or a list of radio buttons.

Dropdown Default Radio buttons

List options

Enter multiple options as a comma-separated list.

For example: "Option 1, Option 2, Option 3"

Add bottom padding


Use Bottom padding to adjust the layout of the product overview section by adding spacing between blocks.

Click Custom option block to find settings

Setting
Description
Options

Bottom padding

Add spacing below the block

1 - 50px

Default: 32px

Last updated