Keystone Documentation

Appearance

Short Text Group ​

Collect multiple related text inputs in a single grouped option with separate labeled fields.

Overview ​

Short Text Group allows you to create multiple short text input fields under a single option. Each field has its own label and appears as a separate input on the storefront, perfect for collecting structured information in one place.

Use Short Text Group for:

  • Contact information (Name, Email, Phone)
  • Address details (Street, City, State, Zip)
  • Shipping and billing info
  • Multiple personalization fields
  • Structured form data

Key characteristics:

  • Multiple labeled text input fields in one option
  • Each field creates a separate single-line input
  • Can be marked as required (all fields required)
  • Supports placeholder text (applies to all fields)
  • Fields can be reordered by dragging
  • Add or remove fields as needed

Configuration ​

Basic Settings ​

SettingDescription
LabelOption name displayed to customers (e.g., "Contact Information")
Option is required for this option setIf enabled, customers must fill all fields before adding to cart
Hide Label from storefrontIf enabled, only the input fields are shown (main label is hidden)

Advanced Settings ​

SettingDescription
Internal LabelAdmin-only identifier (replaces label in options list)
Help TextAdditional guidance shown to customers (based on display mode)
PlaceholderGray text shown inside empty input fields (applies to all fields)

Text Input Labels ​

SettingDescription
Label [1, 2, 3...]Individual label for each text input field (max 255 characters per label)

Managing fields:

  • Add Value button adds new text input fields
  • Drag handle (⋮⋮) to reorder fields
  • X icon to delete individual fields
  • Each label creates a separate text input on storefront

How to Add Short Text Group ​

  1. Navigate to Option Sets and open your option set
  2. Click Add Option
  3. Select Short Text Group from the Option Type modal
  4. Enter a Label (e.g., "Contact Details")
  5. Check Option is required if all fields must be filled
  6. In Text Input Labels, configure your fields:
    • Enter label for each field (e.g., "Name", "Email", "Phone")
    • Click Add Value to add more fields
    • Drag fields to reorder
    • Click X to remove fields
  7. (Optional) Click Advanced Settings to add Placeholder or Help Text
  8. Click Save in the contextual save bar

Use Cases ​

Contact Information ​

Label: Contact Information Required: Yes Text Input Labels:

  • Name
  • Email
  • Phone Number

Result: Three required fields for customer contact details in one grouped option

Shipping Address ​

Label: Shipping Address Required: Yes Text Input Labels:

  • Street Address
  • City
  • State/Province
  • Postal Code

Result: Structured address collection with four separate fields

Recipient Details ​

Label: Gift Recipient Information Required: No Text Input Labels:

  • Recipient Name
  • Recipient Email
  • Gift Message

Result: Optional grouped fields for gift recipient details

Business Contact ​

Label: Business Information Required: Yes Placeholder: Please fill all fields Text Input Labels:

  • Company Name
  • Contact Person
  • Department
  • Email Address

Result: Required business contact form with four fields and shared placeholder

Multiple Personalizations ​

Label: Personalize Each Item Required: No Text Input Labels:

  • Item 1 Name
  • Item 2 Name
  • Item 3 Name

Result: Group of personalization fields for multiple items in one order

Styling ​

Short Text Group input fields inherit styling from your theme and customization settings:

Best Practices ​

Group related fields:

  • Keep fields logically related (all contact info, all address fields)
  • Don't mix unrelated information in one group
  • Use multiple Short Text Groups for different categories
  • Clear grouping improves form completion rates

Order fields logically:

  • Put most important fields first
  • Follow standard form conventions (Name before Email)
  • Match expected customer flow
  • Use drag handles to reorder easily

Use clear field labels:

  • Be specific: "Email Address" not just "Email"
  • Match placeholder to label for clarity
  • Keep labels concise (max 255 characters)
  • Avoid redundant words across labels

Set appropriate requirements:

  • Make entire group required only if all fields needed
  • Consider using separate options for optional fields
  • Required group means all fields must be filled
  • Test checkout flow with requirements

Consider field count:

  • 2-5 fields per group works best
  • Too many fields can overwhelm customers
  • Split large forms into multiple groups
  • Balance convenience with completeness

Choose between Short Text Group and individual Short Text options:

  • Use Short Text Group for: Related data, structured forms, grouped info
  • Use separate Short Text options for: Unrelated fields, conditional visibility, different requirements
  • Groups keep forms cleaner and more organized
  • Individual options offer more flexibility