Build a form
An Optical Form form is a multi-step flow the customer completes on the product page.
The four forms you already have
Section titled “The four forms you already have”When you installed, we left you four ready-made sample forms, all in Draft: prescription glasses as a full-screen configurator (with sample treatment colours), prescription glasses in a side panel, sunglasses in dark mode and contact lenses. Neither is assigned to a product, so nothing shows on your store until you want it to.
Start from one of those, not from a blank one. They come with the steps, the wording and the design already wired up, and every part is editable — far quicker than assembling your own from scratch.
Switching one to Active
Section titled “Switching one to Active”A form in Draft is invisible to everyone. To publish it:
- Forms → open the one you want to use.
- On the Settings tab, change Status from Draft to Active.
- Save. When you save, the app publishes it to your store within seconds — see Sync.
For it to actually appear you need all four at once: Active, Synced, assigned to a product, and the app embed enabled on your theme.
Create the form
Section titled “Create the form”- In the app: Forms → Create form.
- Choose a starting template or start blank:
- Prescription Glasses — lens type → material → coating → graduation → summary.
- Prescription Glasses · Full screen — the same flow as a split screen, with selectable colours on the treatments.
- Contact Lenses — pack, per-eye prescription according to the product’s lens model (it starts with a generic model), and care solutions.
- Sunglasses · Dark — sun only or prescription → prescription → tint → polarization → accessories. Born with the Dark design preset (charcoal ground, vermilion accent) and an icon set drawn for a dark ground: a configurator that reads as part of the product. Made for sunglasses and premium frames.
- Blank Form — one empty step to build from scratch.
- Name it, choose the status (Draft / Active) and create.
Step types
Section titled “Step types”On the Steps tab, each step has an Input type that defines how it renders:
| Input type | What it’s for |
|---|---|
| Single select | Pick one option (lens type, treatment). |
| Multiple select | Pick several (combinable filters or treatments). To show the customer there is more to add, you choose between a checkbox on every option and a note above the continue button. |
| Graduation (Rx) | Per-eye capture (OD/OS): SPH, CYL, AX and, if you turn them on, ADD, PD and prism. See Prescription capture. |
| Reading Rx (grid) | Magnification grid for reading glasses. |
| File upload | The customer uploads their prescription (image or PDF). See File upload. |
| Text input | Free note from the customer. |
| Accessories (cross-sell) | Add extra products to the order. See Add-ons & accessories. |
| Graduation summary | Shows the entered prescription before finishing. |
| Contact lenses | Per-eye prescription with only the values that lens is made in, according to its lens model; boxes per eye and a readable line on the order. |
| Contact lenses (ERP catalogue) | The previous contact-lens step: prescription read from the fabrication catalogue your ERP provides, and the exact manufacturer reference on the order. |
| Product variants | Lets the customer pick the variant inside the form. Hides itself when the product has only one variant. |
Step settings
Section titled “Step settings”Every new step is born with a name: the second one is called “Step 2” and its first option “Option 1”, with its admin ID already set. That way you can save and try the form without filling anything in first, and rename things once you know what the step asks. The same happens when you duplicate a step or an option.
At the top of the step sits what you use every day:
- Step title — the question the customer reads, for example “What type of lens do you need?”.
- Admin ID — a name just for you, to recognise the step in the editor. It never shows in the store.
- Input type — how the customer answers: the table above.
- Text above the options — a short instruction the customer reads before choosing. On steps that aren’t option steps (prescription, upload…) this field is called Step description.
- Text below the options — the tip the customer would ask the optician for in store: “Most people choose the thin lens”, “If you spend hours at a screen, the filter pays off”. On steps that aren’t option steps it’s called Closing note.
Everything else lives at the end of the step, in a folded box: Advanced settings. Closed, a grey line sums up what’s on, for example “Required · price: added cost only”. That way you can tell without opening it whether anything is out of the ordinary. Open it only to change one of these settings; each one shows only on the steps where it makes sense.
Behaviour
- Required — the customer has to answer this step to continue.
- Skip the step when it has only one option — single-select steps only, and off by default. Switched on, when a product is left with a single option on that step (one pack, one possible treatment), the app picks it for the customer, sends it to the order and moves straight to the next step: nobody sees a screen with a single card. It does not skip when the option carries selectable colors or a message with a button, nor when the skip would end the form. Off, a one-option step shows as it is: sometimes that screen is there on purpose.
- How customers know they can pick several — multi-select steps only: a checkbox on every option, or a note above the continue button.
Price
- Price shown on the options — which amount each card of the step shows: the added cost only (“+$25”, the default), a starting price, the total price or the option’s own price. Each option can carry its own with Price shown on this option. The four modes, with an example, in Pricing and charging.
- Show «0» instead of «Included» — on options that cost nothing, shows
$0.00instead of the word “Included”.
Visibility
- Don’t show in the final summary — this step’s answer doesn’t appear in the summary or in the footer tags. Useful for steps that only route the customer.
- Don’t show in the cart or the order — the answer isn’t added to the cart line or the order. It doesn’t appear on steps that carry the prescription. When to use it, in Design and cart.
Anatomy of an option
Section titled “Anatomy of an option”In select steps, each option is a card the customer can pick. Its fields follow the order you think an option through: first what the customer sees, then how the price shows, then what is charged, and finally where it leads.
What the customer sees
- Title — the option’s name on the card: “Progressive”, “Anti-reflective”.
- Admin ID — a name just for you, like the step’s. It comes pre-filled (“Step 1 · Option 1”) and never shows in the store.
- Description — a short sentence under the title.
- Help text — optional. Fill it in and a “?” appears next to the title that the customer opens to read a longer explanation (on hover or tap). That way the description can stay short. Its look is set in Design › Tooltips and help.
- Features — up to four short tags under the description (“Less glare”, “For screen use”) saying what the customer gets from this option. Click Add feature and pick from the catalogue or write your own. They don’t change the price and never reach the order. Catalogue ones translate themselves into the customer’s language; your own you translate like any other field.
- Option label — a label next to the title: “Recommended”, “Best value”, “Most popular”… Click Choose label and pick a ready-made one (it translates itself and comes with its color) or write your own and pick its color. One per option. It doesn’t choose for the customer or change the order: to show it first, drag the option up. The “Recommended” text is edited under Design › Texts.
- Image — click Browse images to pick one of your Shopify Files, or paste its web address.
How the price shows
- Price shown on this option — “Same as the step” by default. Change it only if this option needs something different from the rest of the step. The four modes, in Pricing and charging.
- Text instead of the price — what reads where the price would go when the option adds nothing: “Included”, “Free”. It’s text only and charges nothing: write a price there without adding an add-on and the customer sees it but doesn’t pay it (see Pricing and charging). If you had already written something like “Best value • $59” on an option that costs $59, the app shows it as a label with nothing for you to do.
- Incompatible with — multi-select steps only: tick the options that can’t be picked together with this one.
What is charged
Each of these two sections carries a grey line under its title saying what it does:
- Add-ons — “Always added when this option is chosen.” The lens type, a treatment, a service. You can let the app create the product with Charge an extra or use one of yours with Use existing products. Both ways, step by step, in Add-ons.
- Selectable colors — “The customer picks one; only that one is charged.” Tints, polarized, photochromic. With Add color and Add group the app creates them; with Use colors from a product you use your own. See Selectable colors.
Where it leads
-
When this option is chosen — the last thing in the option. What happens when the customer picks it:
- Continue to the next step — the usual, and the default.
- Finish and add to cart — the option closes the form.
- Go to: … — jumps to a specific step (see below).
- Show a message and a button, without adding to cart — for appointments, in-store-only products or a WhatsApp link. Pick it and its fields appear: see External action.
On multi-select steps you’ll only see “Continue to the next step” and the message with a button, because there the path is set by the step, not by each option.
Conditional branching
Section titled “Conditional branching”With When this option is chosen › Go to: … each option can lead to a different step: that’s how “Prescription glasses” and “Reading glasses” take different paths from the same first step. The editor’s flow diagram draws every jump.
If no answer leads to a step — for example, because every option on the step before jumps past it — your customers will never see it. The editor warns you at the top of the form, “N steps are never shown: no path leads to them”, with each step’s number and name. Check where the answers of the earlier steps lead, or delete the step if it is no longer needed.
Assign & design
Section titled “Assign & design”- Products — assign the form to individual products or to whole collections. What wins when they overlap, and what happens with large collections: Products and collections.
- Design — colors, typography and which data shows in the cart. See Design & cart.
- Publishing — when you save, the changes reach the store on their own. See Sync.