Keystone Documentation

Appearance

Descriptive Text ​

Display static text content to provide information, instructions, or descriptions to customers.

Overview ​

Descriptive Text is a non-interactive option type that displays static content on your product page. Customers cannot edit or interact with it—it's purely informational.

Use Descriptive Text for:

  • Product instructions or care information
  • Important notices or disclaimers
  • Sizing guides or measurement tips
  • Formatting breaks between option groups
  • Context for other options

Key characteristics:

  • No customer input required
  • Cannot be marked as required
  • Supports plain text content
  • Displays as formatted text on storefront

Configuration ​

Basic Settings ​

SettingDescription
LabelOption name (shown in admin and optionally on storefront)
Hide Label from storefrontIf enabled, only text content is shown (label is hidden)

Advanced Settings ​

SettingDescription
Internal LabelAdmin-only identifier (replaces label in options list)
Help TextAdditional context (appears based on display mode setting)

Static Text Content ​

SettingDescription
Text ContentThe static text displayed to customers on the product page

How to Add Descriptive Text ​

  1. Navigate to Option Sets and open your option set
  2. Click Add Option
  3. Select Descriptive Text from the Option Type dropdown
  4. Enter a Label (or hide it if you only want text content shown)
  5. In Static Text Content, enter your text
  6. (Optional) Click Advanced Settings to add Internal Label or Help Text
  7. Click Save in the contextual save bar

Use Cases ​

Care Instructions ​

Label: Care Instructions Text Content: "Hand wash cold. Lay flat to dry. Do not bleach or iron."

Result: Displays care instructions above or near related options

Sizing Information ​

Label: Size Guide Text Content: "Please refer to our size chart. If between sizes, we recommend sizing up for a comfortable fit."

Result: Helps customers make informed size selections

Important Notice ​

Label: (Hidden) Text Content: "This is a made-to-order item. Please allow 3-5 business days for production before shipping."

Result: Displays notice without a label, appearing as plain text

Section Break ​

Label: Personalization Options Text Content: "Add a personal touch to your order:"

Result: Creates a clear visual section header for grouped options

Disclaimer ​

Label: (Hidden) Text Content: "Custom engraved items are final sale and cannot be returned or exchanged."

Result: Important legal/policy information displayed inline

Styling ​

Descriptive Text inherits styling from your theme and customization settings:

Best Practices ​

Keep it concise:

  • Short, scannable text works best
  • Use multiple Descriptive Text options instead of long blocks
  • Break up lengthy information into smaller sections

Hide label when appropriate:

  • Enable "Hide Label from storefront" for plain text notices
  • Keep label visible for titled sections or headings
  • Test both approaches to see what looks better

Use for context, not input:

  • Never ask customers to input information in descriptive text
  • Use actual input fields (Text Input, Text Area) for customer data
  • Descriptive Text is view-only

Strategic placement:

  • Place before related options to provide context
  • Use between option groups as section dividers
  • Add at the end for disclaimers or additional info

Combine with styling:

  • Use consistent formatting across your option sets
  • Match your brand's tone and voice
  • Consider mobile readability