Lens models
Every contact lens is only made in certain prescriptions. A spherical might go from −12.00 to +8.00; a daily toric only exists in some axes; a multifocal asks for the addition in bands like “Low · Med · High”. If the form let customers pick any value, they could order a lens that doesn’t exist, and you would find out when ordering from your distributor.
A lens model is the record of one specific lens with everything it is made in. You assign it to your contact-lens products, and the form’s Contact lenses step only lets customers pick those values. It also chains them: once the sphere is chosen, only the cylinders that exist for it show; once the cylinder is chosen, only its axes. What the manufacturer doesn’t make can’t be ordered.
There is one model per lens, not one per store.
In five minutes: selling one lens
Section titled “In five minutes: selling one lens”Say, Biofinity toric:
- In the app, open Lens models and click From a preset. A preset is a template with the values the manufacturer publishes.
- Search for “Biofinity toric” and click Use this preset. Your copy is created and opens.
- Check the values against what your distributor supplies and click Save. In the list, the model turns Published within seconds.
- Inside the model, under Products with this model, click Add products and pick your “Biofinity toric” product.
- Check that the product has a form assigned with a step of type Contact lenses. The sample “Contact lenses” form already has one: assign it to the product and activate it, as explained in Switching one to Active. Open the product page in your store and try it.
The price comes from your Shopify product: set the price of one box on the variant. The configurator multiplies it by the boxes the customer orders.
The abbreviations
Section titled “The abbreviations”They’re the ones on any contact-lens prescription. In case whoever sets up the store isn’t an optician:
| Abbreviation | What it is |
|---|---|
| SPH (sphere) | The main prescription: negative for short-sightedness, positive for long-sightedness. |
| CYL (cylinder) | The astigmatism correction. Toric lenses only. |
| AX (axis) | Which way the astigmatism points, in degrees from 0 to 180. Always goes with the cylinder. |
| ADD (addition) | What’s added for near vision. Multifocals only. |
| D/N | Design for the dominant or the non-dominant eye. Some multifocals ask for it. |
| BC (base curve) | How curved the lens is, so it sits well on the eye. |
| DIA (diameter) | The size of the lens, in millimetres. |
Where to set it up
Section titled “Where to set it up”- Lens models, in the app menu: the list of your models, with their kind, replacement, brand, whether they’re published, and how many products use each. At the top you have New model, From a preset and Import.
- The step of type Contact lenses in your form, on the Steps tab.
- The form’s Products tab, where each product carries its model.
What your store starts with
Section titled “What your store starts with”The app leaves five sample models, from three brands: clariti 1 day, ACUVUE OASYS 1-Day for ASTIGMATISM, Biofinity multifocal, AIR OPTIX plus HydraGlyde and AIR OPTIX COLORS. They’re yours: edit them, assign them to your products or delete them. If you already had models, none is added.
The sample “Contact lenses” form and the “Contact lenses” template under New form use this step with a generic model. As soon as you assign a model to a product, the step offers that model’s prescriptions.
Creating a model
Section titled “Creating a model”From a preset (the fastest)
Section titled “From a preset (the fastest)”Click From a preset. There are 22 templates taken from each manufacturer’s technical guide: CooperVision, Johnson & Johnson Vision, Alcon and Bausch + Lomb. There are sphericals, torics, multifocals, a multifocal toric, colour lenses and myopia control. Each one says which guide it comes from and when we read it. Search by brand, model or kind and click Use this preset.
What gets created is a copy of your own. It opens in the editor with the note “Created from the preset … Check the ranges with your distributor”, and you change it as you like. If we correct the template later, your copy doesn’t change.
From scratch
Section titled “From scratch”Click New model. It starts with a generic sphere, from −12.00 to +6.00, so you can type just the name and save. Normally you fit it to the lens, section by section.
Lens
- Name — required. It’s what your customer reads on the order, for example “Biofinity toric”.
- Brand and Manufacturer model.
- Kind — spherical, toric, multifocal, multifocal toric, colour, myopia control or other.
- Replacement — daily, weekly, two-weekly, monthly, quarterly, yearly, conventional or other.
Sphere (SPH)
Spheres are written as runs. A run is a range with a fixed jump: From, To and Step.
- “From −6.00 to +6.00 in 0.25” means −6.00, −5.75, −5.50… up to +6.00.
- If past −6.00 the lens goes in halves, add a second run with Add run: from −6.50 to −12.00 in 0.50.
- A single value is a run with the same From and To, for example +32.00 after a run that ends at +30.00.
- Tick Includes 0.00 (plano) if the lens is also made with no prescription.
Cylinder and axis (CYL · AX) — torics only
Here you say which cylinders and axes are made, and with which spheres. It’s done in blocks. Each block has three things:
- Sphere runs — which spheres this block goes with. Usually “All runs”.
- Cylinders — a comma-separated list:
-0.75, -1.25, -1.75, -2.25. - Axes — a list of single values and ranges.
10-180/10means “from 10 to 180, in tens” (10, 20, 30… 180).10, 20, 70-110/10, 160-180/10means 10, 20, from 70 to 110 in tens, and from 160 to 180 in tens.
With a single block, every cylinder goes with every axis. If the manufacturer’s guide says, for example, that cylinder −2.25 only exists in some axes and for some spheres, click Add block and describe that exception there.
Addition (ADD) — multifocals only
- Turn on This lens has additions and write them as the manufacturer publishes them: “Low · Med · High” or “+1.00 … +2.50”.
- Each addition has a Code, which is what travels on the order, and the Text shown to the customer.
- Ask the D/N design per eye adds the dominant / non-dominant choice to each eye.
Fitting parameters
- Base curve (BC) and Diameter (DIA) — one or several values separated by commas. With a single value, the customer sees it as a fixed fact, with nothing to choose.
- If the base curve changes with the diameter, the sphere or the design, see Base curve by diameter, sphere or design.
Colour — colour lenses only
- Turn on This lens comes in colours and write the colour names.
- Each colour can take a Swatch and an Image. The swatch is a colour code, for example
#6e4b2e, which you can get from any colour picker. The image is a photo of the eye wearing the lens: click Choose to take it from your Shopify Files, or paste its web address. - If any colour has a swatch or an image, the step shows a colour grid above both eyes. The customer taps a colour and it applies to both; each eye keeps its list in case they want a different one. With no swatches or images, the colour is picked from a list of names.
- The colour-lens templates come with indicative swatches. The photo is yours to add.
Boxes per eye
- The Minimum and Maximum boxes the customer can order per eye. If you leave them, 1 to 10.
How your customer will see it
While you edit, this box shows how many combinations per eye the model allows and the selectors as your customer will see them. Pick a sphere and you’ll see which cylinders and axes remain. It’s the best way to check you wrote the runs and blocks right.
If something is wrong
The error shows next to its field and won’t let you save until you fix it. The most common:
- two sphere runs that overlap;
- a “To” that the step can’t reach: from −6.00 to +6.10 in 0.25 stops at +6.00, so the app asks you to fix it;
- a toric with no blocks, or a block naming a run you’ve deleted;
- a sphere that’s in no block, because nobody could buy it;
- a section turned on but with no values;
- more than 500 values in one field.
Saving and publishing
When you click Save, the model is published to your store. In the list you’ll see its status:
| Status | What it means |
|---|---|
| Publishing… | It’s being saved to your store. It takes a few seconds. |
| Published | The store already uses this version. |
| Publish failed | Shopify rejected it; you’ll see the reason. The store keeps using the previous version of the model. Open it and save again to retry. |
Base curve by diameter, sphere or design
Section titled “Base curve by diameter, sphere or design”You only need this part for some lenses. In custom-fit lenses, each diameter has its own curves. In others, one curve is for short-sightedness and another for long-sightedness, or plano only exists in one curve. If yours is an ordinary lens, skip it.
To say so, under Fitting parameters tick Only some base curve and diameter combinations are made and write one row per combination that exists:
- Diameters and Base curves — those of that combination, separated by commas. Empty means “all”.
- Spheres from and Spheres to — optional. Which spheres that combination goes with, for example from −16.00 to −0.25 for short-sightedness. An empty end doesn’t limit.
- Design — only if the model asks for the D/N design: D, N or D and N.
What the customer chooses is valid if it fits some row. If a curve goes with two separate sphere ranges, write two rows.
If your supplier gives you the table in writing, click Paste combinations and paste it as is, for example Ø11.5, Ø12: 6.5, 6.8, 7.1; Ø12.5: 6.5, 6.8. The app tells you how many rows come out and what it didn’t understand. When you click Apply, it replaces the rows and adds any missing values to the base curve and diameter lists. You narrow the spheres and design afterwards, row by row.
It won’t let you save if a row names a curve or a diameter the model doesn’t have, if a curve or a diameter in the lists is in no row, or if some sphere is left without a curve (for example 0.00, if no row covers it). How your customer will see it counts only the combinations that exist and chains the curve and diameter too.
If you untick the box, the rows are deleted on save. Tick it again before saving to get them back.
Duplicate, export and import
Section titled “Duplicate, export and import”- Duplicate creates a copy called “Name (copy)”, with no products assigned.
- Export downloads the model as a file (JSON format) you can keep or take to another store.
- Import creates a model from that file, in this store or another. The imported model is yours, with no origin note and no products, and goes through the same checks as when saving.
Import also takes several files at once, or one file with several models inside:
- With a single one, it opens in the editor so you can review it before saving.
- With several, they’re created one by one; the button says which one it’s on. At the end, a notice says how many went in and which didn’t, with the reason.
- Colours and additions can come as a plain list of names, and the replacement written in words (“monthly”, “quarterly”…).
- A model with a piece of data the app doesn’t understand isn’t imported halfway: it shows in the notice with the name of that data.
Assigning the model to your products
Section titled “Assigning the model to your products”A product sells one model only. If you assign it another, it moves, and the app tells you which one it came from.
You can assign it from two places:
- From the model — under Products with this model, click Add products and pick in Shopify’s picker; you can pick several at once. Each product has Remove.
- From the form — on its Products tab, if the form has a Contact lenses step, each product carries the Lens model selector. There you also see the ones with no model: “No model: the step’s default model” or “No model (the step has no default either)”.
The assignment is stored on the product itself in your store, like the form’s. If you delete a model that products use, the app tells you how many before you confirm. Those products go to the step’s default model or, if there is none, lose the configurator button until you assign them another.
The form’s “Contact lenses” step
Section titled “The form’s “Contact lenses” step”On the Steps tab, add a step and choose the type Contact lenses.
The step’s settings:
- Default lens model — used by products that have no model of their own. Copy from one of my models or From a preset leaves a copy here; Clear removes it; Update from “X” copies again if you changed the source model. It can stay empty if all your products carry their own.
- Eyes — Ask for both eyes, or Allow a single eye: the customer can then switch one eye off, and that eye doesn’t go on the order.
- Presentation — how the Colour is picked: folded (one row that opens on tap; the default), open grid, compact grid, horizontal carousel, sheet over the form, or only each eye’s dropdown. And how many Columns on desktop (by width, or 3 to 6) and Columns on phones (by width, or 2 to 4). The alignment of the steps’ title and description lives in Design › Typography.
- Texts — every text the customer sees on this step, per language: the help above the eyes, “Right eye”, “Left eye”, “Boxes”, the error and notice messages, the summary label and the “Model” line of the order.
The sample form Contact lenses and the template of the same name already use this step, with a generic model from −12.00 to +6.00 as the default: replace it with yours.
What the customer sees
Section titled “What the customer sees”- One card per eye with only the fields of its model. A toric asks for sphere, cylinder and axis; a multifocal for sphere, addition and D/N design; a spherical only for the sphere. A base curve or a diameter with a single value shows as a fixed fact.
- Every selector starts on “—”. Nothing comes pre-chosen.
- The selectors are chained. If the customer changes the sphere and the cylinder or axis they had no longer exist for it, they go back to “—” and the customer is told.
- If the model has curve and diameter combinations, the base curve only offers those that exist with the chosen sphere (and design), and the diameter only those that exist with that curve. If the choice leaves a single one, it shows as fixed with a line saying why: “With what you chose, this lens is only made with BC 8.7.” If it rules out the one they had, it goes back to “—” and they’re told.
- Next to the fields they read “Use the values of your contact lens prescription, not your glasses one”, because they’re not the same prescription. You change it under Texts.
- To continue they have to fill in every field of each eye ordered and at least one box. An eye switched off doesn’t count.
- The total is the variant’s price × the boxes of both eyes.
What is left on the order
Section titled “What is left on the order”The order carries one line of the product, with a quantity equal to the boxes of both eyes. On it goes each eye’s prescription, readable and in the customer’s language, for example:
OD: SPH -2.25 · CYL -0.75 · AX 90° · BC 8.6 · DIA 14.2 · Boxes 2If the model’s name isn’t the product’s title, “Model: …” goes too.
- Full or compact. Under Design › Cart lines, the Contact lens prescription in the cart setting decides how that line is written. Full, the default, is the one above: abbreviation and value of each field, with base curve and diameter even when fixed. Compact keeps only what the customer chose, without abbreviations: “OD: -2.25 · -0.75 · 90° · ×2”. A base curve or diameter left fixed by the choice also goes on the compact line. It only affects contact lenses; glasses stay as they are.
- Hiding the prescription from the customer. The Hide prescription values from the customer and Hide selection labels from the customer checkboxes on the Design tab apply here too.
For your management software (ERP)
Section titled “For your management software (ERP)”If you have management software connected, like Gesvisión, on the Integrations tab, and the step has its code, the order also carries the prescription in the format it understands, without the customer seeing it. With Gesvisión, the order’s accessories travel too, as an add-on sale.
The manufacturer reference only goes when the product’s fabrication catalogue has exactly one row matching the choice. With no catalogue, or when several rows match, it’s empty.
Technical detail, for whoever sets up the integration. The prescription travels hidden under the step’s field name, in the format of the Contact lenses (ERP catalogue) step. Per eye it carries sphere (SPH), cylinder (CYL), axis (Axis), addition (ADD, with the model’s addition code), D/N design (Geometry), diameter (Dia), base curve (Bc), colour (Color, with its code), boxes (Quantity) and manufacturer reference (sku). An eye not ordered travels as zeros. With Gesvisión, accessories go as upsell.
Languages
Section titled “Languages”Additions and colours are translated inside the model. The step’s texts, on the step card, per language. The abbreviations, the help and the errors come in English and Spanish: if you sell in another language, they show in your store’s primary language if it’s Spanish, and in English otherwise.
What it does not do
Section titled “What it does not do”- It doesn’t convert a glasses prescription into a contact-lens one, nor check prescriptions.
- It doesn’t guess the manufacturer reference: with no fabrication catalogue, or when several rows match, it’s empty.
- It doesn’t allow a different model per eye, nor a different product per eye in the same order.
- It doesn’t update your copies when we change a template.
- It doesn’t tie the cylinder, axis or addition to the base curve or diameter, nor set a different price per combination.
If you uninstall the app and install it again, the models are published to your store again on their own, like the forms. See Synchronisation.