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
Help textOptional text shown next to this specific value on the storefront — see Value Help Text below
PricingThree options: Free (default), Add fee, Link variant

Value Help Text ​

Every checkbox value has its own optional Help text field (separate from the option-level Help Text under Advanced Settings) — a short hint like "Adds 2 business days" that appears right next to that value.

  • Leave it blank and nothing renders — no icon, no empty gap
  • Shows on the storefront, in the Live Preview, and in the option-set Details preview
  • Persists through Save + refresh and through duplicating the option or option set
  • How it looks — a line under the value, or an ⓘ icon with a hover tooltip — is controlled per-template in Checkbox Styling

Value Help Text vs. Help Text

The Help Text field under Advanced Settings applies to the whole option. Value Help Text applies to one specific checkbox value. Both can be used together.

Changing option type resets values

Switching this option's type (e.g. Checkbox to Radio) resets its values to defaults after a confirmation warning — any per-value help text is lost along with the rest of the value's settings. Only the option's own label and help text survive a type change.

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 ​

Checkbox has its own dedicated styling — item style, the selection box and its glyph, label typography, value help text, layout, disabled state, and quantity input are all configurable via named templates.

See Checkbox Styling for the full settings reference.

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