Skip to content

Short Text Styling ​

Style every visual detail of the Short Text option type — the field, its label and help text, the colors it takes while a customer types, and how it looks when validation fails — using per-type templates.

Overview ​

Read Types Settings first if you haven't created a template before. This page covers every setting available once you're editing a Short Text template, grouped the same way they appear in the editor's left navigation.

Short Text is the first text-entry type you can style, and the first whose template covers the label and help text as well as the field itself. That has one consequence worth knowing up front: the template's Help text display replaces the store-wide Help Text Display Mode for every option using it.

Three states, not two

Most types are styled for idle and hover. A text field has nothing to select, so its third state is focus — the field the customer is currently typing in. Background, border and text color are set separately for Idle, Hover and Focused.

A new template starts from your shop's theme: the idle colors and sizes seed from your Colors and Borders & Shapes. Hover and focus colors are derived to differ from idle, so the three states never look identical out of the box.

This styles Short Text only

Short Text Group is a separate option type and doesn't use these templates. The other text-entry types — Paragraph Text, Email, Telephone, Number — aren't stylable yet either.

Field Style ​

The structural choice — pick it first, since it decides which of the settings below appear at all.

SettingWhat it controlsDefaultOptions
Field styleThe overall look of the fieldOutlinedOutlined, Filled, Underline

In-app help: Outlined draws a border around the field. Filled is a tinted box with no border, so the border settings are hidden. Underline draws only a bottom line on a transparent field, so corners, shadow and the background colors are hidden.

SettingWhat it controlsShown forDefaultOptions / Range
CornersCorner rounding of the fieldOutlined, FilledGlobalGlobal, Pill, Square, Custom
Corner radius (Custom corners only)Exact corner roundingOutlined, Filled6px0–40px
SpacingField padding and height togetherAll stylesComfortableComfortable, Compact
Border widthBorder thickness — on Underline, the thickness of the lineOutlined, Underline1px (from your theme border width)0–4px
ShadowDrop shadow under the fieldOutlined, FilledNone (from your theme input shadow)None, Subtle, Medium, Strong

"Global" corners can look square

Global follows your store's corner radius from Borders & Shapes — so if that radius is 0, the field renders square. Pick Pill, Square or Custom when you want a specific shape regardless of the global value.

Label & Help Text ​

Two sections in one pane: where the label sits, and how the option's help text is presented.

Label ​

SettingWhat it controlsDefaultOptions / Range
Label positionWhere the label sits relative to the fieldAboveAbove, Left
Label width (Left only)Width of the label column140px60–320px
Space between label and fieldGap between the two4px0–24px
Label sizeLabel text size16px10–28px
Label weightLabel text weightSemiboldRegular, Medium, Semibold, Bold
Label colorLabel colorTheme text color—

Left labels stack on phones

Left places the label beside the field on wide screens only; on phones it stacks above the field automatically. If you use Left, set the same Label width on every Short Text option so their fields line up down the page.

Help text ​

SettingWhat it controlsDefaultOptions
Help text displayHow the option's help text is shownAbove fieldAbove field, Below field, Tooltip, Hidden

In-app help: Replaces the store-wide Help Text Display Mode for options using this template. Tooltip shows an "i" beside the label that reveals the help text on hover.

Shown for Above field and Below field:

SettingWhat it controlsDefaultRange
Help text colorHelp text color#4B5563 (falls back to theme text)—
Help text sizeHelp text size14px10–20px
Help text styleHelp text styleItalicItalic, Regular

Shown for Tooltip:

SettingWhat it controlsDefaultRange
Icon colorThe "i" beside the label — on hover it fills with the tooltip colors#6B7280 (falls back to theme text)—
Tooltip positionWhether the bubble opens above or below the "i"TopTop, Bottom
Tooltip backgroundBubble fill#1F2937—
Tooltip textBubble text color#FFFFFF—
Tooltip text sizeBubble text size14px10–18px
Tooltip max widthWidest the bubble gets before the text wraps250px120–400px

Help text display overrides your store-wide setting

This is the one setting here that changes what shows, not just how it looks. For every option using this template, it replaces the store-wide Help Text Display Mode.

With Hidden, no help text appears on those options at all, even when the option has some — the text stays saved, it just isn't rendered.

Short Text options with no template assigned keep following the store-wide setting, as before.

Field Colors ​

Placeholder is set once. Background, Border and Text are each set separately for three states: Idle, Hover, and Focused (while the customer is typing).

SettingWhat it controlsShown forIdleHoverFocused
PlaceholderThe hint text in the empty fieldAll styles#6B7280 (theme placeholder) — one value for all states
BackgroundField fillOutlined, Filled#FFFFFF (theme input background)#F9FAFB#FFFFFF
BorderBorder, or the underline, colorOutlined, Underline#D1D5DB (theme input border)#9CA3AF#2563EB
TextThe typed text colorAll styles#111827 (theme input text)#111827#111827

Why text color is the same in all three states

Background and border carry the state signal. The typed text stays the theme's input text color in all three so it remains readable — including on a dark storefront, where a derived hover or focus text color could drop out of contrast.

The focus Border color is what shows while the customer types. The ring drawn around the field is separate — see Focus, error & disabled.

Text ​

How what the customer types is rendered.

SettingWhat it controlsDefaultOptions / Range
Font sizeSize of the typed text14px10–28px
Font weightWeight of the typed textRegularRegular, Medium, Semibold, Bold
Letter spacingSpacing between characters0px−1 to 4px, in steps of 0.5
Text alignmentAlignment of the typed textLeftLeft, Center, Right
Mobile font sizeOverrides the font size at 768px wide and belowEmpty (uses the desktop size)10–24px

Focus, Error & Disabled ​

SettingWhat it controlsDefaultRange
Focus ringThe ring around the field while it's focusedOn—
Focus ring colorRing color#2563EB (falls back to your theme button color)—
Focus ring widthRing thickness2px1–5px
Error colorThe message under the field, and the field's border, when validation fails#DC2626—
Disabled opacityHow faded the field looks when the theme disables the form50%10–100%

Seeing the error state

Error color applies when a customer submits an invalid field — typically a required Short Text left empty on Add to cart. You don't have to reproduce that on a live storefront to style it: turn on Show error state in Manage preview — see Sandbox & Live Preview.

Turning the focus ring off

With the ring off, the only thing marking the active field is the Focused border color from Field colors. Make sure that color is clearly different from Idle, or customers won't be able to tell which field they're in. On the Underline style, the ring is drawn as a thicker line rather than a ring.

How to Style Short Text ​

  1. Open the Style Settings modal (see Customization Overview)
  2. Click Types → Short Text
  3. Create a new template or click an existing one to edit it
  4. Use the left navigation to jump between Field style, Label & help text, Field colors, Text, and Focus, error & disabled
  5. Switch between the Idle, Hover and Focused tabs to set each state's colors
  6. Click Manage preview to put your own label, placeholder and help text in the preview, or to see the error state — see Sandbox & Live Preview
  7. Click Save in the contextual save bar

Assign the template on the option itself: open a Short Text option, expand Style settings, and pick a template card.