Frequently Asked Questions

Find answers to common questions about Product Options.

Getting Started

How do I install the app?

After installing from the Shopify App Store, you need to add the Product Options app block to your theme:

1. Go to Online Store > Themes > Customize
2. Navigate to a product page
3. Click Add block and select Product Options
4. Position it where you want options to appear (typically above Add to Cart)
5. Save your theme

See App Block Installation for detailed instructions.

Do I need coding knowledge to use this app?

No coding is required for Shopify 2.0 themes. The app uses Shopify's app block system and automatically inherits your theme's styling. All configuration is done through a visual interface.

For legacy (1.0) themes, some basic code editing is required to install a Liquid snippet. See Legacy Theme Installation for guidance.

Will this app slow down my store?

No. Product Options is optimized for performance and loads efficiently. The app block integrates seamlessly with Shopify's native systems.

Can I try before purchasing?

Yes! Install the app and test it in development or with a small product set to ensure it meets your needs before going live.

Option Sets & Products

What is an option set?

An option set is a collection of custom options (like text fields, dropdowns, checkboxes) that you assign to products or collections. Think of it as a template that can be reused across multiple products.

How do I assign an option set to products?

There are three ways:

• Individual products: Select specific products manually
• Collections: Assign to entire collections automatically
• All products: Apply to your entire catalog

See Product Selection for details.

Can one product have multiple option sets?

No. Each product can only have one option set assigned. However, an option set can contain many different options.

What happens if I delete an option set?

The option set is permanently deleted and removed from all assigned products. Options will no longer appear on those product pages. This action cannot be undone.

Can I duplicate an option set?

Yes. To duplicate an option set:

1. Go to the Option Sets page
2. Click the eye icon next to the option set you want to duplicate (opens preview)
3. Click the duplicate icon in the top right corner
4. A copy of the option set is created as a starting point for similar products

Option Types

What's the difference between Short Text and Paragraph Text?

• Short Text: Single-line input for brief text (names, codes, short messages)
• Paragraph Text: Multi-line input for longer content (detailed instructions, messages with line breaks)

When should I use Dropdown vs Radio buttons?

• Dropdown: Use for 5-15 options when you want to save space (collapsed until clicked)
• Radio: Use for 2-6 options when you want all choices immediately visible

What's the difference between Checkbox (Single) and Checkbox (Multi)?

• Checkbox (Single): One checkbox for yes/no decisions (e.g., "Add gift wrapping?")
• Checkbox (Multi): Multiple checkboxes where customers can select several options

When should I use Swatches instead of Dropdowns?

Use Swatches for visual decisions (colors, patterns, materials) where seeing the option is more helpful than reading text. Use Dropdowns for text-based selections.

Can I mix different option types in one option set?

Yes! An option set can contain any combination of option types (text inputs, dropdowns, checkboxes, swatches, etc.).

What file types can customers upload?

Typically: JPG, JPEG, PNG, GIF, SVG, WEBP for images, and PDF for documents. File size limits are configured in app settings (typically 5-50MB).

Pricing & Add-Ons

How do I add pricing to options?

Each option value can have pricing configured with three methods:

• Free: No additional cost (default)
• Add Fee: Set a specific price (e.g., +$5.00)
• Link Variant: Connect to existing Shopify product for price syncing

See Price Add-Ons for details.

What are hidden products and why do they exist?

When you use "Add Fee" pricing, the app automatically creates hidden (draft) products in Shopify to handle the pricing in cart/checkout. This is a technical requirement of how Shopify processes add-on pricing.

Important: Do not edit or delete these hidden products manually.

Can I change an option's price after creating it?

Yes. Edit the option, update the price in the pricing section, and save. For "Add Fee" pricing, the hidden product price automatically updates.

Why isn't my option price showing in the cart?

Check:

• You've saved the option set after adding pricing
• The pricing is set correctly (not still set to "Free")
• Clear browser cache and test again
• Verify the option set is assigned to the product

Can I have free and priced options in the same option set?

Yes! Some options can be free while others have pricing. For example, standard colors might be free while premium colors cost extra.

Required Fields & Validation

What does "Required" mean for an option?

Required options must be filled or selected before customers can add the product to cart. The add-to-cart button is disabled until all required fields are completed.

Can I make Descriptive Text required?

No. Descriptive Text is purely informational and cannot be marked as required since customers don't interact with it.

What happens if a customer tries to checkout without filling required fields?

They cannot add the product to cart until all required fields are completed. Clear validation messages guide them to complete missing fields.

How do I set up validation messages?

Required field validation messages can be customized in Customization > Storefront Settings > Language Settings. Default is "{option} is required".

Conditional Logic

What is conditional logic?

Conditional logic allows you to show/hide options based on conditions like:

• Other option values selected
• Time/date
• Product attributes
• Customer attributes

See Conditional Logic for all condition types.

Can I show an option only on certain days?

Yes! Use "Day of Week" or "Date Range" conditions to control when options appear.

How do I make an option appear only for logged-in customers?

Use the "Customer is logged in" condition type to show options exclusively to authenticated customers.

Can I combine multiple conditions?

Yes! Use "ANY" logic (if any condition matches) or "ALL" logic (if all conditions match). You can also add multiple logic rule boxes with "ALSO" between them.

Why isn't my conditional logic working?

Check:

• Conditions are saved correctly
• Logic operator is correct (ANY vs ALL)
• Referenced options exist and are configured properly
• Test in storefront (Preview mode has limitations)

Customization & Styling

How do I change the colors of my options?

Go to Customization > Colors tab to customize:

• Background colors
• Text colors
• Button colors
• Input field colors
• Border colors

Can I change the size of swatches?

Yes. Go to Customization > Borders & Shapes and adjust the Swatch Size setting (16px - 80px).

How do I make corners rounded or sharp?

Go to Customization > Borders & Shapes and adjust the Corner Radius settings:

• 0px = Sharp corners
• 4-20px = Slightly rounded
• 40-100px = Very rounded

What templates are available?

The app includes several pre-designed templates:

• Theme Default: Inherits your theme's styling
• Additional templates with different visual styles

Apply templates in Customization > Templates tab.

Can I edit the JSON configuration directly?

Yes! Advanced users can use Customization > Advanced Styling to edit the complete JSON configuration directly. However, this requires knowledge of JSON syntax.

Will my customizations affect my theme?

No. Customizations only affect the Product Options app styling, not your overall theme.

Label & Text Settings

What is Internal Label?

Internal Label is an admin-only name that replaces the Option Label in your options list. It's useful for organization without affecting what customers see on the storefront.

What's the difference between Placeholder and Help Text?

• Placeholder: Gray text inside empty input fields (disappears when typing)
• Help Text: Additional text displayed below or as tooltip (always visible based on display mode)

How do I hide labels on the storefront?

Enable "Hide Label from storefront" when configuring an option. The option still works but the label doesn't appear to customers.

What is Max Length used for?

Max Length sets a character limit for text input fields (Short Text or Paragraph Text). Useful for physical constraints like engraving space or keeping input manageable.

Storefront Display

How do I control where options appear on my product page?

Use the Theme Customizer to position the Product Options app block. Typically it's placed above the Add to Cart button.

Can I show prices in dropdowns?

Yes. Prices automatically display inline with option values in dropdowns, like "Large (+$10.00)". The format can be customized in Storefront Settings.

What are the price display modes?

Three modes in Storefront Settings:

• Add to Price: Shows total price ($74.95)
• Append to Price: Shows base + extras ($29.99 + $44.96)
• Display below options: Shows detailed breakdown at bottom

How does Help Text display work?

Three display modes (set in Storefront Settings):

• Help Text: Shown as small text below option
• Tooltip: Shown as (ⓘ) icon on hover
• Off: Hidden

Can I support multiple languages?

The admin interface supports multiple languages (auto or manual selection in App Settings > Language Settings). For customer-facing text, you can customize language strings in Storefront Settings.

Orders & Cart

Where do I see customer input in orders?

Option selections and input appear in Shopify order details under each product. All customer entries are attached to the order.

Do uploaded files save with orders?

Yes. Uploaded files are securely stored and accessible from order details in Shopify admin for fulfillment.

Can customers edit options after adding to cart?

They can remove the item and add it again with different options. Direct editing in cart depends on your theme's capabilities.

How do option prices appear at checkout?

Each selected option appears as a line item under the base product with its name and price, then the total is calculated.

Troubleshooting

Options not showing on my product page

Check:

• App block is installed in theme
• Option set is assigned to the product
• Option set status is "Active"
• Clear browser cache
• Test in incognito/private mode

Changes not saving

Check:

• You clicked the Save button in the contextual save bar
• No error messages appeared
• Internet connection is stable
• Try refreshing and making changes again

Prices not calculating correctly

For Add Fee:

• Don't edit hidden product prices manually
• Update prices through the app only

For Link Variant:

• Check linked product still exists
• Verify linked product price is correct
• Re-link the product if needed

Images not uploading

Check:

• File format is supported (JPG, PNG, GIF)
• File size is under limit (typically 5-50MB)
• Internet connection is stable
• Try a different/smaller file

Conditional logic not triggering

• Conditions only work on storefront (not in Preview)
• Verify all referenced options exist
• Check logic operators (ANY vs ALL)
• Test thoroughly on actual product pages

Swatch colors look different on mobile

• Colors may appear different on various screens
• Use Help Text to note colors are approximate
• Consider providing physical samples
• Test on actual devices

App block not appearing in theme editor

• Ensure app is properly installed
• Check you're on Shopify Online Store 2.0 theme
• Try refreshing the theme editor
• If using a legacy (1.0) theme, see Legacy Theme Installation
• Contact support if issues persist

Technical & Advanced

Does the app work with subscription products?

Yes. Product Options works with most subscription apps, but test your specific setup to ensure compatibility.

Can I use conditional logic with inventory?

Yes. Use "Product variant inventory" conditions to show/hide options based on stock levels.

How do I export/backup my configurations?

Use Customization > Advanced Styling to copy your JSON configuration and save it as a backup file.

Can I copy configurations between stores?

Yes. Copy the JSON from Advanced Styling on one store and paste it into another.

Are there API limits?

The app operates within Shopify's API limits. Normal usage won't encounter issues, but very high-volume automated actions might.

How do I migrate from another product options app?

You'll need to manually recreate your option sets. There's no automatic import from other apps. Start with your most important products first.

Can I use custom CSS with the app?

While the app provides extensive customization options, adding custom CSS directly isn't supported. Use the built-in customization settings instead.

Pricing & Billing

How am I charged for this app?

Pricing is based on your chosen plan. Check the Shopify App Store listing for current pricing tiers and features.

Can I change my plan later?

Yes. You can upgrade or downgrade your plan anytime through the Shopify admin.

Is there a free trial?

Check the app listing in the Shopify App Store for current trial offerings.

What happens if I uninstall the app?

All option sets and configurations are removed. Options will no longer appear on product pages. Hidden products created for pricing will remain (can be deleted manually).

Getting Help

Where can I find more documentation?

Browse the complete documentation:

• Getting Started Guide
• Configuration Guides
• Option Type References
• Customization

How do I contact support?

Email support at: support@key-stone.app

What should I include when contacting support?

For faster help, include:

• Description of the issue
• Screenshots or screen recordings
• Steps to reproduce the problem
• Your store domain
• Affected products or option sets

Can I request new features?

Yes! We welcome feature requests. Contact support with your ideas and use cases.

Best Practices

How many options should I add to a product?

Balance completeness with simplicity:

• 2-6 options: Ideal for most products
• 7-10 options: Acceptable but test UX
• 10+ options: Consider if all are necessary

Too many options can overwhelm customers.

Should I make all options required?

Only require fields that are essential. Optional fields reduce friction and improve conversion rates.

How do I test options before going live?

1. Create option set on test/draft product first
2. Test all option types and combinations
3. Verify pricing calculates correctly
4. Check mobile responsiveness
5. Test checkout flow completely

What's the best way to organize option sets?

• Use descriptive names
• One option set per product type
• Group related products with same option set
• Use Internal Labels for admin organization
• Regular review and cleanup

How often should I review my options?

Review quarterly or when:

• Launching new products
• Changing pricing
• Customer feedback suggests improvements
• New features become available

Contact Us

Need more help? Have questions not answered here?

Email us: support@key-stone.app

Our support team is here to help you get the most out of Product Options.