Custom options

Product page block

Update This feature was added in v1.4.0 on Oct 6, 2022. See our Changelog and theme update guide to learn more.

Note 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.

In the Product template, you can add Custom options to let customers personalize products or customize their order before updating their cart. For example, customers can enter personal text for engraving, click a checkbox to 'Agree' to terms, or add instructions to their order (like free gift wrapping).

This guide shows how to add five different types of options. You can add multiple options of the same type or a combination. Any text and selected options will appear in the cart and order details.

  • Single-line text

  • Multi-line text

  • Checkboxes

  • Dropdown menus

  • Radio buttons

Watch tutorial

Add text field (single and multi-line)

The Text field type is for a single line of text. The Long text block is for multiple lines of text.

STEPS

In your theme editor (Customize):

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

  2. Click on the new Custom option block to open the settings.

  3. Under Field type, select Text or Long text.

  4. Enter short text for the Field label that titles what the custom field is for.

    Note: For multiple custom option blocks, each block must have a unique Field Label. Blocks with the same Field label will overwrite each other. Learn more about Line item properties.

  5. Enter Instructions to tell customers about the options and any requirements (e.g., a maximum of 10 words).

    To show different instructions on different product pages, you can create multiple templates or use dynamic sources.

  6. Change the Field placeholder text that appears until the customer enters their own text.

    The default placeholder is "Enter your text here." You may want to change the wording to be more specific.

  7. (Return to Product Overview.) Click and hold the drag handles ⋮⋮ to rearrange the blocks:

    Click Remove block in the block settings to delete a block.

    Click the Eye icon to hide or unhide a block.

  8. Click Save.

Add checkbox option

The Checkbox gives customers a 'yes' or 'no' option. You can add multiple checkboxes to let customers select one or more options from a set of options.

STEPS

In your theme editor (Customize):

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

  2. Click on the new Custom option block to open the settings.

  3. Under Field type, select Text or Long text.

  4. Enter short text for the Field label that titles what the custom field is for.

    Note: For multiple custom option blocks, each block must have a unique Field Label. Blocks with the same Field label will overwrite each other. Learn more about Line item properties.

  5. Enter Instructions to tell customers about the options and any requirements (e.g., a maximum of 10 words).

    To show different instructions on different product pages, you can create multiple templates or use dynamic sources.

  6. Change the Field placeholder text that appears until the customer enters their own text.

    The default placeholder is "Enter your text here." You may want to change the wording to be more specific.

  7. (Return to Product Overview.) Click and hold the drag handles ⋮⋮ to rearrange the blocks:

    Click Remove block in the block settings to delete a block.

    Click the Eye icon to hide or unhide a block.

  8. Click Save.

Add dropdown options

With a Dropdown, customers must select a single option from a list of items in a menu.

STEPS

In your theme editor (Customize):

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

  2. Click on the new Custom option block to open the settings.

  3. Under Field type, select List.

  4. Enter short text for the Field label that titles what the custom field is for.

    Note: For multiple custom option blocks, each block must have a unique Field Label. Blocks with the same Field label will overwrite each other. Learn more about Line item properties.

  5. Enter Instructions to tell customers about the options and any requirements (e.g., a maximum of 10 words).

    To show different instructions on different product pages, you can create multiple templates or use dynamic sources.

  6. Under List style, select Dropdown.

  7. Enter multiple options as a comma-separated list.

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

  8. (Return to Product Overview.) Click and hold the drag handles ⋮⋮ to rearrange the blocks:

    Click Remove block in the block settings to delete a block.

    Click the Eye icon to hide or unhide a block.

  9. Click Save.

Add radio buttons

With Radio buttons, customers must select a single option from a list of buttons.

STEPS

In your theme editor (Customize):

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

  2. Click on the new Custom option block to open the settings.

  3. Under Field type, select Dropdown.

  4. Enter short text for the Field label that titles what the custom field is for.

    Note: For multiple custom option blocks, each block must have a unique Field Label. Blocks with the same Field label will overwrite each other. Learn more about Line item properties.

  5. Enter Instructions to tell customers about the options and any requirements (e.g., a maximum of 10 words).

    To show different instructions on different product pages, you can create multiple templates or use dynamic sources.

  6. Under List style, select Radio buttons.

  7. Enter multiple options as a comma-separated list.

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

  8. (Return to Product Overview.) Click and hold the drag handles ⋮⋮ to rearrange the blocks:

    ![../../.gitbook/assets/shopify-content-drag-handles.jpeg)

    Click Remove block in the block settings to delete a block.

    Click the Eye icon to hide or unhide a block.

  9. Click Save.

\


Related links

Product template

Last updated