Keystone Documentation

Appearance

Checkbox (Single) ​

Present customers with a single yes/no or opt-in choice using one checkbox.

Overview ​

Checkbox (Single) is a selection option type that displays a single checkbox for a simple yes/no decision. Customers check the box to opt-in or leave it unchecked to opt-out. It's ideal for single optional add-ons or agreement confirmations.

Use Checkbox (Single) for:

  • Gift wrapping option
  • Insurance or warranty add-ons
  • Express shipping upgrades
  • Special handling requests
  • Terms and conditions agreement

Key characteristics:

  • Single checkbox (one value only)
  • Simple checked/unchecked state
  • Can be marked as required
  • Supports pre-selection (checked by default)
  • Can have price add-on

Configuration ​

Basic Settings ​

SettingDescription
LabelCheckbox text displayed to customers (e.g., "Add gift wrapping?")
Option is required for this option setIf enabled, customers must check the box before adding to cart
Hide Label from storefrontIf enabled, only the checkbox is shown (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)

Checkbox Settings ​

SettingDescription
Pre-selected by defaultIf enabled, checkbox is checked when page loads
PricingThree options: Free (default), Add fee, Link variant

Pricing Options ​

Free (Default) ​

No additional cost when checkbox is checked.

When to use: Informational choices, non-priced opt-ins

Add Fee ​

Manually set a specific price that's added when checkbox is checked.

Example: Add gift wrapping (+$5.00)

How it works:

  • You enter the price amount
  • App creates a hidden Shopify product automatically
  • Price is added to cart when checked

Hidden Products

The app creates hidden products for Add Fee pricing. Do not edit or delete these products in Shopify.

Connect the checkbox to an existing Shopify product for automatic price syncing.

Example: Link to your Gift Wrapping product

How it works:

  • You select an existing product
  • Price automatically syncs with that product
  • Updates when you change the linked product price

How to Add Checkbox (Single) ​

  1. Navigate to Option Sets and open your option set
  2. Click Add Option
  3. Select Checkbox (Single) from the Option Type modal
  4. Enter a Label (e.g., "Add gift wrapping (+$5.00)")
  5. Check Option is required if checkbox must be checked (rare use case)
  6. (Optional) Click Advanced Settings to add Help Text
  7. Configure checkbox settings:
    • Check Pre-selected by default if desired
    • Set Pricing (Free, Add fee, or Link variant)
  8. Click Save in the contextual save bar

Use Cases ​

Gift Wrapping ​

Label: Add gift wrapping (+$5.00) Required: No Pre-selected: No Pricing: Add Fee: $5.00

Result: Optional gift wrapping checkbox with $5 add-on

Express Shipping ​

Label: Upgrade to express shipping (+$15.00) Required: No Pre-selected: No Pricing: Add Fee: $15.00 Help Text: Receive your order in 2-3 business days

Result: Optional shipping upgrade with pricing and timeline

Insurance Coverage ​

Label: Add shipping insurance (+$3.00) Required: No Pre-selected: Yes (recommended) Pricing: Add Fee: $3.00

Result: Pre-checked insurance option (customer can uncheck)

Special Handling ​

Label: This is a gift Required: No Pre-selected: No Pricing: Free Help Text: We'll include a gift receipt and remove prices

Result: Free informational checkbox for gift orders

Extended Warranty ​

Label: Add 2-year extended warranty (+$49.00) Required: No Pre-selected: No Pricing: Link Variant: Warranty Product

Result: Optional warranty with linked product pricing

Customer Experience ​

Checkbox interaction:

  1. Customer sees label with checkbox
  2. Clicks checkbox to check (opt-in)
  3. Checked box shows checkmark
  4. Clicks again to uncheck (opt-out)
  5. If priced and checked, price adds to cart

Price display:

  • Price typically shown in label: "Add gift wrapping (+$5.00)"
  • Total updates in cart when checked
  • Item listed at checkout if checked

Styling ​

Single checkbox inherits styling from your theme and customization settings:

Best Practices ​

Use clear labels:

  • Include price in label: "Add gift wrapping (+$5.00)"
  • Be specific: "Express shipping (2-3 days)" vs "Fast shipping"
  • Action-oriented: "Add..." vs just "Gift wrapping"
  • Keep concise and scannable

Consider pre-selection:

  • Pre-check recommended options (insurance, warranties)
  • Test impact on conversions
  • Don't pre-check if it feels pushy
  • Use for genuine recommendations

Pricing best practices:

  • Always show price in label when charging
  • Use Add Fee for fixed costs
  • Use Link Variant for existing products
  • Keep pricing transparent

Set appropriate requirements:

  • Required checkboxes are rare (typically for agreements)
  • Most checkboxes should be optional
  • Required = must be checked to proceed
  • Test user experience with requirements

Consider checkbox (single) vs other types:

  • Use Checkbox (Single) for: One yes/no choice, simple opt-in
  • Use Checkbox (Multi) for: Multiple selections from list
  • Use Radio for: Choice between 2+ mutually exclusive options
  • Single checkbox is clearest for opt-in/opt-out

Mobile optimization:

  • Single checkboxes work well on mobile
  • Ensure adequate tap target size
  • Keep label text concise
  • Test that price displays clearly

Use Help Text wisely:

  • Explain benefit: "Protects your order during shipping"
  • Clarify what happens: "We'll include a gift receipt"
  • Mention important details: "Delivery in 2-3 days"
  • Keep it brief