For the complete documentation index, see llms.txt. This page is also available as Markdown.

Choose the right option type

A decision table that starts with what you want to ask customers for and guides you to the right option type.

Thirty-two types is a lot to keep in your head. This page works backwards: start with what you want to ask customers for, and it tells you which option type to use.

By what you are asking for

You want the customer to…
Use

Type a short message, name, or engraving

Type a longer message with line breaks

Enter a quantity or a measurement

Enter two or three measurements with units

Pick a number from a range, visually

Give you a phone number

Give you an email address, for example for a digital gift

Choose a delivery or event date

Upload a photo, logo, or artwork

Choose any color at all

Say yes or no to one thing

Switch, or a single Checkbox

Choose one from a short list

Choose one from a long list

Dropdown with search

Choose several from a list

Choose a color from your palette

Choose a pattern, material, or design you photograph

Choose a color from a long list, compactly

Choose a design from a long list, compactly

Choose a font for their engraving

Jump to a related product instead of choosing an option

When you are not asking for anything

You want to…
Use

Group options under a heading, or make a group collapsible

Add a heading between options

Separate two groups visually

Explain something in a sentence or two

Explain something at length without lengthening the page

Show a size table

Show care instructions, delivery information, and returns in one place

Embed something the other types cannot produce

Send a fixed value to the order without showing anything

Choices that look similar

Text or Textarea?

Text is a single line, while Textarea supports multiple lines. Otherwise, they work almost the same, including add-on pricing and Personalizer support.

Use Text for names, short messages, and engravings. The single-line format keeps the input concise. Use Textarea for gift messages, instructions, and other longer text.

There is one difference in the Personalizer settings. Textarea offers Text alignment, Width, and Height because it can contain multiple lines. Text offers Curve and Auto-fit max width because it is designed for a single line.

Select or Dropdown?

Select
Dropdown

Appearance

The browser's native dropdown

Styled by the app, matching your design settings

Search

No

Yes

Color or image per entry

No

Yes

Min and max selections

No

Yes

Out-of-stock display

No

Yes

Personalizer

No

Yes

Select is the simple, dependable choice — it uses the device’s native picker, which mobile customers are already familiar with. Dropdown is better when you need a richer or more customizable selection experience.

Radio button, Button, or Color swatch?

All three let customers choose one value from a list, and all three support Swatch style for displaying colors or images. The main difference is how the choices are presented:

  • Radio button — a vertical list. Best for longer value names or when you use per-value help text.

  • Button — a row of tappable buttons. Best for short values such as sizes.

  • Color swatch / Image swatch — a grid of visual choices. These are the only two that support slider layouts.

Switch or Checkbox?

A Switch is a single yes-or-no choice with its own label, such as “Add gift wrap.” A Checkbox is a list of choices and also works when there is only one. Use Switch for a single toggle and Checkbox when customers need to choose from two or more items.

Number, Range slider, or Dimension?

  • Number — a typed number. Best when precision matters and customers can enter any value within the allowed range.

  • Range slider — a draggable value. Good for approximate choices, but less suitable when customers need to enter a precise value.

  • Dimension — two or three measurements with their own units and pricing formula. Use it for made-to-measure products.

Color picker or Color swatch?

Color picker lets customers choose any color from the full spectrum. Color swatch lets them choose from a predefined set of colors. If you can only produce a limited selection of colors, use swatches — a picker may encourage customers to request colors you cannot provide.

File upload or the Personalizer?

These features work together rather than as alternatives. File upload collects the customer’s file. Enabling Personalizer on the same option also displays the uploaded image on the product photo as a live preview. See Product Personalizer.

By what you need it to do

You need…
Types that can

A price attached to the whole option

Text, Textarea, Number, Switch, Color picker, Dimension

A price attached to each choice

All nine selection types with values

The customer's content drawn on the product photo

Text, Textarea, Number, File upload, Dropdown, Color dropdown, Image dropdown, Radio button, Checkbox, Button, Color swatch, Image swatch

Stock tracking per choice

Any selection type, with values linked to add-on products

To work in Shopify POS

Everything except Dimension and Product links

Several choices at once

Checkbox always; Select, Dropdown, Color dropdown, Image dropdown, Button, Color swatch, Image swatch with Allow multiple

Search within a long list

Dropdown, Color dropdown, Image dropdown, Font picker

A collapsible or slider layout

Checkbox, Radio button, Button, Color swatch, Image swatch

A rule of thumb

Fewer, simpler options are usually better than more, complicated ones. Before adding an option type, ask yourself whether the customer’s answer changes what you make or ship. If it doesn’t, leave it out. If it only matters in certain cases, put it behind conditional logic so most customers never have to see it.

Last updated

Was this helpful?