Option ElementsInput TypesText Input

Text Input

A single-line text field. The most common input type — suitable for names, short messages, engraving text, monograms, and any other short free-form entry.


When to use

  • Customer name or initials for engraving/monogramming
  • Short personalization message (e.g., “Happy Birthday Tom”)
  • Custom reference or order number
  • Any single-line custom field

For longer text, use Text Area.


General settings

SettingDescription
LabelField label shown on the storefront
Internal nameAdmin-only label — not shown to customers
RequiredCustomer must enter a value before adding to cart
Hide labelHides the label in the storefront UI
Help textShort guidance below the field
PlaceholderGreyed-out hint text inside the input before typing
Default valuePre-fills the field with this text

All of these settings — plus everything below — live in one scrollable panel on the right side of the element editor, with the live Storefront Preview next to it:

Text Input settings panel showing Label, Name, Required field, and Hidden label


Text constraints

SettingDescription
Min lengthMinimum number of characters allowed
Max lengthMaximum number of characters. A live character counter appears on the storefront once set.
Allow valueRestrict what characters can be typed: Any characters (default), Letters only, or Letters and numbers (no special characters or spaces)

Scroll down in the same settings panel to find the Allow value options, along with Price per character and Text transform (covered below):

Text Input settings scrolled to show Allow value options, Price per character, and Text transform


Text transform

SettingDescription
Text transformNone (customer types as-is), Always uppercase (input is automatically uppercased), Always lowercase

Useful for products where the final output is always in a specific case (e.g., a rubber stamp that only prints uppercase).


Prefix / Suffix

SettingDescription
PrefixFixed text displayed before the input field (e.g., # for hashtag, $ for currency)
SuffixFixed text displayed after the input field (e.g., cm, %, USD)

Prefix and suffix are display-only — they appear in the UI but are not added to the submitted value. Scrolling further down the settings panel also shows the Placeholder, Default value, and Help text fields from the General settings table above:

Text Input settings scrolled to show Prefix, Suffix, Placeholder, Default value, and Help text fields


Pricing

SettingDescription
Price per characterA fee charged for each character the customer types. Leave blank for no per-character charge. See Per-Character Pricing for full details.

Personalizer tab

When the Personalizer is enabled for this element, the typed text is rendered as a live overlay on the product image. See Product Personalizer for full setup.


Storefront behavior

  • Displays as a standard single-line text box
  • Live character counter shown when min/max length is configured
  • Text transform is applied visually as the customer types
  • Required validation fires on add-to-cart — field highlighted in red if empty
  • The customer’s answer is recorded on the order.