Limits
Min and max characters, values, selections, and files — plus the character counter that shows customers where they stand.
There are four pairs of min/max settings, each used by a different group of option types, plus a character counter. The rules are the same for all of them: leave one limit empty to make that end unlimited; enter a limit to have the app validate it before Add to cart.
How many choices were made
Checkbox, and any multi-select selection type
Min and max character
Default
Both empty — no limit at either end
Available on
Text, Textarea
How it behaves
Counts all characters, including spaces and punctuation.
Leaving Min character empty means any length is allowed, including a single character.
Leaving Max character empty means there is no upper limit.
Validation runs when the customer selects Add to cart, not while they are typing. Add a Character counter if you want live feedback.
Setting Max character below Min character is rejected while editing, with the message
The value must be greater than min.
Typical uses
Engraving on a ring band
—
15
Two initials for a monogram
2
3
Gift message on a card
—
200
Special instructions, guarding against nonsense
10
500
Related: Per character add-on pricing charges based on how much the customer types, making it a natural fit for a maximum character limit. See Advanced add-on modes.
Character counter
Shows a live count as the customer types.
Default
Hide
Available on
Text, Textarea
Set it to Show to display a running character count. The wording is store-wide and editable in Settings > Translations: {{character_count}}/{{character_limit}} characters. See Translate widget text.
Turn it on whenever you set a Max character. It gives customers feedback while they type instead of waiting until Add to cart to discover that their input is too long. This lets them adjust their text before submitting the form.
Min and max value
Default
Both empty on Number. On Range slider, 0 and 100
Available on
Number, Range slider
How it behaves
On Number, the limits define what values the customer can enter. Leave one limit empty to make that end unbounded.
On Range slider, the limits define the two ends of the slider track, so customers cannot select a value outside the range. The slider also has a Step setting that controls the increment — see Range slider.
A Default value outside the range is rejected while editing, with the message
The value must be between min and max.
Typical uses
Number of embroidered names
1
6
Width in centimetres you can cut
10
240
Guest count for a catering order
4
100
Discount-free donation amount
1
—
When a number is used to calculate a price, these limits also protect against zero or negative values. See Dimension add-on formula for size-based pricing.
Min and max selections
Default
Both empty
Available on
Checkbox always; and on Dropdown, Color dropdown, Image dropdown, Button, Color swatch, and Image swatch once Allow multiple is turned on
How it behaves
Counts the number of values the customer selects.
On multi-select types, these settings appear only after Allow multiple is enabled. A single-select option can have only one selection.
Setting Min selections and Max selections to the same number means “exactly this many.” The app uses a specific validation message:
Please select exactly {{exactly_selection}} options.Required field and Min selections overlap: Required field means at least one selection, which is the same as Min selections = 1. Use Required field for the simple case and Min selections when you need to require more than one selection.
Typical uses
Pick any three toppings
3
3
Up to two free extras
—
2
At least one flavour in a box of six
1
6
Choose two to four colors
2
4
Min and max number of files
Default
Both empty
Available on
File upload, once Allow multiple is on
How it behaves
Both settings accept a value between 1 and 20. The app rejects anything outside this range with the message:
The value must be between 1 and 20 (or max).The fields appear only after Allow multiple is enabled for the option.
The maximum number of files a customer can upload at once, as well as the maximum file size, is also limited by your plan. The option-level limit cannot exceed the plan limit.
Setting Min files and Max files to the same number requires exactly that many files.
Typical uses
One photo to print
Leave Allow multiple off
A photo collage of exactly four images
4
4
Up to ten reference images
—
10
At least two angles of a garment for repair
2
6
See File upload for the allowed file extensions and the rest of the settings.
Limits and validation together
Min character
Please enter more than or equal to {{min_character}} characters
Max character
Please enter less than or equal to {{character_limit}} characters
Exact character count
Please enter exactly {{exactly_character}} characters
Min value
Please enter a value greater than or equal to {{min_value}}
Max value
Please enter a value less than or equal to {{max_value}}
Exact value
Please enter a value equal to {{exactly_value}}
Min selections
Please select at least {{min_selection}} options
Max selections
Please select at maximum {{max_selection}} options
Exact selections
Please select exactly {{exactly_selection}} options
Min files
Please add more than or equal to {{min_files}} files
Max files
Please add less than or equal to {{max_files}} files
Exact files
Please add exactly {{exactly_files}} files
Every message is editable per storefront language, and the {{ }} placeholders fill themselves in from your settings. See Translate widget text and Validation messages.
Last updated
Was this helpful?