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

Text

A single-line field for names, engravings, and short messages — with character limits, input rules, per-character pricing, and live preview support.

The customer types directly into the field. It is the most commonly used option type in the app and the foundation for many personalization setups.

Use it for anything short and singular: a name to engrave, two initials, a team number, or a reference. For text longer than one line, use Textarea instead.

Watch it done — 1:28. Adding a field for a name, an engraving, or a short note, so the detail arrives with the order instead of by email afterwards.

What customers see

A single-line field with your label above it, optionally with a character counter, a prefix, and a suffix.

A text field on a storefront product page with a label, placeholder, and character counter
A text option with a character counter and help text.

Basic

Setting
What it does

The text above the field.

The name on the cart and order. Unique, no . : " ' \ |.

Blocks add to cart until something is typed.

Hides the label on the product page.

How short and how long the entry may be.

Example text inside the empty field.

A line of guidance that stays visible.

Pre-fills the field.

Show or Hide a live count as they type.

The add-on charge, under Add-on Settings.

Show or hide this option based on other choices.

Advanced

Setting
What it does

How the add-on scales — including Per character.

The number used by the fixed and dynamic quantity modes.

Restrict to letters, or letters and numbers.

Force uppercase, lowercase, sentence case, or capitalised.

Where the help text sits.

Fixed text after the field, such as a unit.

An icon or short text inside the start of the field.

A CSS class for your own styling.

How much width the field takes.

Add-on pricing

The price applies to the whole option because there is only one answer. All three add-on modes are available — link an existing product, generate one automatically, or simply add a price. See Add-on pricing.

Text and Textarea are the only two types that support the Per character advanced mode, which charges based on the number of characters the customer enters. It is a natural way to price engraving:

Configuration
Result for "Forever yours" (13 characters)

Price $0.50, mode Per character

$6.50

Price $5.00, mode Default

$5.00 whatever they type

Price $5.00, mode One time charge

$5.00 even if they buy three bracelets

Pair Per character with a Max character so the charge has a clear ceiling. See Advanced add-on modes.

Personalizer

Text is fully supported by the live preview: the customer’s text appears on the product photo as they type.

Its personalizer settings include color, font size, font style, font family — including a default font, a Google font, or one of your uploaded fonts — as well as position, opacity, rotation, five text effects, a crop area, and the transformations customers are allowed to apply.

Two settings are specific to Text and Number because they are single-line types: Curve, which bends the text along an arc, and Auto-fit max width, which reduces the font size when the text becomes too long for the available space. See Curve and auto-fit width.

Full detail: Product Personalizer.

Examples

Engraving with a hard limit

Setting
Value

Label / Name

Engraving text

Max character

15

Character counter

Show

Allowed value

Letters & numbers

Text transform

Capitalized

Price

Fixed amount $5.00, mode Default

Help text

Up to 15 letters and numbers. Engraved items cannot be returned.

Two initials for a monogram

Min character 2, max character 3, Text transform UPPERCASE, Allowed value Letters, required on.

A team number on a jersey

Max character 2, Allowed value Letters & numbers, placeholder 10, Column width 25% so it sits beside the name field.

Notes

  • Available on all plans.

  • Works in Shopify POS.

  • Character limits count spaces and punctuation.

  • Validation runs on Add to cart, not while typing — the counter is what gives live feedback.

  • An empty, non-required Text option submits nothing, and no empty line is added to the order.

Last updated

Was this helpful?