For the complete documentation index, see llms.txt. This page is also available as Markdown.

Overview

Everything you need to do once to get your first custom option live on your storefront.

This section takes you from a fresh setup to a working custom option on a live product page. Read the pages in order the first time — each step builds on the previous one.

Watch it done — 4:25. A complete walkthrough: replacing basic variants with text boxes, file uploads, and image swatches, and charging extra for an upgrade.

What needs to be done before options appear

Four things. If your options aren’t showing on the storefront, one of these is likely the reason.

#
What
Why

1

The app is completely installed and you have chosen a plan

On first open the app takes you to Pricing and will not let you past it until you choose. The free plan counts as a choice.

2

You have built an option set

The options themselves — the questions you want to ask the customer.

3

That option set is Active, published to Online Store, and its product rule matches the product you are looking at

A new option set starts in Draft status and won’t appear on your storefront until it’s published. The product rule determines which products the option set applies to.

4

The app embed is enabled on your live theme

This is what actually adds the widget to your storefront. Installing the app does not enable it automatically, and you’ll need to enable the app embed again whenever you publish a new theme.

Steps 2 and 3 are hard to get wrong because the builder won’t let you save an option set until it has at least one option and a product rule. Step 4 is the one people are most likely to miss.

Pages in this section

What you need before you begin

  • A Shopify store where you can install apps. If you’re a staff member, you need the Apps permission. If you’re a collaborator, the store owner must approve the app installation.

  • Access to the theme where you want the options to appear. You’ll need to open the Shopify theme editor to enable the app embed.

  • At least one product to test with. A draft product is fine for testing, as long as you can access its product page.

Nothing in this section changes your theme's code. The app renders through Shopify's theme app extension system, which you switch on and off from the theme editor.

Last updated

Was this helpful?