# GetOptical Docs — full documentation

> Documentación de Optical Form, la app de Shopify de GetOptical que añade a la ficha de producto un configurador de lentes multipaso para vender gafas graduadas y lentes de contacto. Documentation for Optical Form, the Shopify app by GetOptical.

Optical Form es una app pública del Shopify App Store, publicada por la marca GetOptical:
https://apps.shopify.com/optical-form

Qué hace: en la ficha de producto, el comprador elige tipo de gafas, lente y tratamientos,
introduce su graduación y añade accesorios; todo entra en el carrito de Shopify.

- Instalación: bloque de tema (app embed). Funciona en cualquier tema, sin desarrollador.
- Diez tipos de paso: single_select, multi_select, text_input, graduation,
  graduation_summary, file_upload, accessories, reading_rx, contact_lens, variant_select.
- Lentillas y subida de receta incluidas en el plan base, no en un nivel superior.
- Precio: un solo plan, Pro, 49 USD/mes o 490 USD/año, prueba gratis de 14 días,
  0% de comisión. Todos los cargos se facturan en USD.
- Idiomas: español e inglés, tanto en la app como en esta documentación.
- Privacidad: la receta no sale del navegador — viaja a las propiedades de línea del pedido
  de Shopify, no a servidores de GetOptical.
- Soporte: support@getoptical.app

English summary: Optical Form is a public Shopify app by GetOptical. It adds a multi-step
lens configurator to the product page: the shopper picks frame type, lens and treatments,
enters their prescription and adds accessories, and it all goes into the Shopify cart.
It installs as a theme block (app embed) and works on any theme, no developer needed.
Ten step types are available (single_select, multi_select, text_input, graduation,
graduation_summary, file_upload, accessories, reading_rx, contact_lens, variant_select).
Contact lenses and prescription upload are included in the base plan. One plan, Pro:
$49/month or $490/year, 14-day free trial, 0% commission, all charges billed in USD.
Spanish and English. The prescription never leaves the browser: it travels to the Shopify
order line item properties, not to GetOptical servers. Support: support@getoptical.app

This file contains every page of https://docs.getoptical.app in full: first the Spanish pages served at the
site root, then the English pages served under /en/. The two trees are translations of each
other, not different content. Each page below starts with its title, its description and the
URL it is served from.

---

# Documentación de GetOptical

> Vende gafas graduadas y lentes en Shopify — 0% de comisión, en cualquier tema.

Source: https://docs.getoptical.app/
Language: es

### Empezar

Lee primero **Antes de empezar**: cuatro decisiones y una lista de productos que evitan rehacer el trabajo. Después instala la incrustación de la app, crea tu formulario y asígnalo a un producto.
[Antes de empezar](https://docs.getoptical.app/empezar/antes-de-empezar/) · [Guía de instalación](https://docs.getoptical.app/empezar/instalacion/) · [Conceptos clave](https://docs.getoptical.app/empezar/conceptos/)

### Crear un formulario

Los 10 tipos de paso, la anatomía de una opción y la ramificación por respuesta. En qué productos aparece, qué pasa con la montura sin lentes, y cómo se publica, se copia y se lleva a otra tienda.
[Crear un formulario](https://docs.getoptical.app/guias/crear-formulario/) · [Productos y colecciones](https://docs.getoptical.app/guias/productos-y-colecciones/) · [Cómo se compra cada montura](https://docs.getoptical.app/guias/evitar-compras-sin-configurar/) · [Sincronización y copias](https://docs.getoptical.app/guias/sincronizacion/) · [Copiar a otra tienda](https://docs.getoptical.app/guias/copiar-formulario/)

### Graduación y receta

Captura SPH, CYL, AX, ADD y DP por ojo, o una rejilla de lectura; o deja que el cliente suba su receta como imagen o PDF. También hay pasos de lentillas, incluidos en Pro.
[Graduación](https://docs.getoptical.app/guias/graduacion/) · [Subida de archivo](https://docs.getoptical.app/guias/subir-receta/)

### Addons, precios e iconos

Vende lentes, tratamientos y cross-sell facturados como líneas separadas; de dónde sale cada euro del total; y un pack de 28 iconos para tus opciones.
[Complementos y accesorios](https://docs.getoptical.app/guias/accesorios-y-addons/) · [Precios y cobro](https://docs.getoptical.app/guias/precios-y-cobro/) · [Iconos](https://docs.getoptical.app/guias/iconos/)

### Diseño, tema y carrito

Colores, tipografía, comportamiento y qué datos se muestran en el carrito; el botón del producto; los ajustes que viven en tu tema y los temas que hemos probado; y de dónde sale cada texto que ve tu cliente.
[Diseño y carrito](https://docs.getoptical.app/guias/diseno-y-carrito/) · [El botón del producto](https://docs.getoptical.app/guias/boton-del-producto/) · [Ajustes del tema](https://docs.getoptical.app/guias/ajustes-del-tema/) · [Temas probados](https://docs.getoptical.app/guias/temas-probados/) · [Idiomas y textos](https://docs.getoptical.app/guias/traducciones/)

### Planes y facturación

Bienvenida de 14 días, prueba gratis de 14 días, 0 % de comisión, y qué cambia al elegir plan.
[Planes y facturación](https://docs.getoptical.app/facturacion/planes/)

### Cuando algo no funciona

Busca tu síntoma, sigue las comprobaciones en orden y para en cuanto una falle. Qué significa cada cifra de Analítica y qué tocar en el paso que pierde clientes. Y las dudas más comunes, respondidas.
[Cuando algo no funciona](https://docs.getoptical.app/guias/cuando-algo-no-funciona/) · [Leer la analítica](https://docs.getoptical.app/guias/analitica/) · [Preguntas frecuentes](https://docs.getoptical.app/faq/)

### Para desarrolladores

Instalación agnóstica al tema, hooks y agrupación de carrito; y si montas la tienda de una óptica para un cliente, Pro gratis en tu tienda de desarrollo.
[Integración](https://docs.getoptical.app/desarrolladores/integracion/) · [Qué hacer con cada evento](https://docs.getoptical.app/desarrolladores/eventos/) · [Botón y carrito](https://docs.getoptical.app/desarrolladores/boton-y-carrito/) · [Agencias y tiendas de desarrollo](https://docs.getoptical.app/desarrolladores/tiendas-de-desarrollo/)

---

# Antes de empezar

> Cuatro decisiones y una lista de productos que conviene tener resueltas antes de tocar la app. Media hora aquí te ahorra rehacer el trabajo.

Source: https://docs.getoptical.app/empezar/antes-de-empezar/
Language: es

Puedes instalar la app y ponerte a construir. Pero hay cuatro cosas que, decididas antes, evitan tener que rehacer formularios y productos a mitad de camino.

Nada de esto se hace dentro de Optical Form: es preparación en tu propia tienda.

## 1. Qué monturas se venden con formulario

No suelen ser todas.

| Se venden **con** formulario | Se venden **normal** |
|---|---|
| Monturas graduadas | Estuches, líquidos, paños |
| Gafas de sol (con tinte, polarizadas o graduadas) | Accesorios y regalos |
| Gafas de lectura a medida y lentes de recambio | Monturas que vendes sueltas, sin lentes |

Esta lista decide dos cosas más adelante: a qué productos asignas el formulario y qué plantilla de producto usan. Escríbela antes de empezar.

**El caso mixto**

¿La misma montura se vende con y sin graduación? **No hace falta duplicarla.** Un solo producto puede llevar los dos botones: el de tu tema, que añade la montura sola, y el de Optical Form, que abre el configurador. Es una decisión de negocio tuya, no un límite de la app — solo hay que ponerle a cada botón un nombre que diga lo que hace. Crea dos productos únicamente si quieres precios, fotos o textos distintos para cada versión. Las dos vías, con sus pasos, en [Controlar cómo se compra cada montura](https://docs.getoptical.app/guias/evitar-compras-sin-configurar/).

## 2. Los productos de tus extras

Aquí está el grueso del trabajo previo, y lo que más gente se salta.

Todo lo que quieras **cobrar aparte** —el tipo de lente, un tratamiento, el montaje— tiene que existir como **producto de Shopify**. No son etiquetas dentro de la app: son productos reales, porque es Shopify quien los factura, los mete en el pedido y los envía a tu laboratorio.

Prepara una lista parecida a esta:

```
Lente monofocal estándar 1.50 ......  0,00 €   (incluida en el precio de la montura)
Lente monofocal fina 1.60 .........  15,00 €
Lente monofocal ultrafina 1.74 ....  50,00 €
Antirreflejante premium ...........  30,00 €
Filtro de luz azul ................  17,00 €
Fotocromático .....................  40,00 €
Montaje ...........................  12,00 €
```

Dos cosas que decidirás con esa lista en la mano y que explicamos en [Precios y cobro](https://docs.getoptical.app/guias/precios-y-cobro/):

- **El precio es el suplemento, no el total.** La montura ya tiene el suyo.
- **Lo que va incluido se crea igual, a 0 €.** Así el cliente ve "Incluido" en vez de un hueco.

**Créalos con el estado «No listado»**

Estos productos no son para navegar: nadie debería encontrar "Antirreflejante premium" en tu colección de gafas. Shopify tiene un estado de producto pensado justo para esto: **No listado** (*Unlisted*, en la página del producto, junto a Activo y Borrador). Un producto no listado **no sale en las colecciones, en el buscador de la tienda, en las recomendaciones, en Google ni en el mapa del sitio**, pero **se puede añadir al carrito y comprar** con normalidad: en el carrito, el checkout y el pedido se comporta como un producto activo.

No los dejes **sin publicar** en el canal Tienda online ni en Borrador: un producto que no está publicado en el canal **no se puede añadir al carrito**, y Shopify rechazaría el añadido entero — tu cliente se quedaría sin la montura también. Activo pero escondido en una colección que no enlazas también funciona, pero sigue saliendo en el buscador.

### Cómo poner un producto en el canal Tienda online

Si un producto ya existe y le falta el canal, añádeselo desde su página de producto:

1. En tu admin de Shopify, ve a **Productos** y haz clic en el nombre del producto.
2. En la sección **Publicación**, haz clic en el icono que hay junto al título.
3. En el cuadro de diálogo, marca **Tienda online** y haz clic en **Listo**.
4. Haz clic en **Guardar**.

Repítelo con cada producto de tus extras. Si no quieres que salga en colecciones ni en el buscador, ponlo en estado **No listado** en esa misma página de producto.

## 3. Cómo vas a asignar el formulario

Dos formas, y conviene elegir antes:

| | Cuándo usarla |
|---|---|
| **Por producto** | Pocas monturas, o cada una con su formulario |
| **Por colección** | Catálogo amplio con un formulario común |

La colección tiene una ventaja que suele decidir: **es viva**. Añades una montura nueva a la colección y ya muestra el formulario, sin volver a la app. Si vas a crecer en catálogo, empieza por ahí.

Crea esa colección ahora si no existe — por ejemplo *Gafas graduadas*.

## 4. Decide cómo se compra cada montura

Tu tema mantiene **sus propios botones de compra**, así que por defecto un cliente puede llevarse la montura sin lentes. Puede que eso te venga bien —hay ópticas que venden monturas sueltas a propósito— o puede que no lo quieras en absoluto. Es tuya la decisión, y conviene tomarla ahora y no cuando ya esté entrando gente.

Las dos vías, con sus pasos: **[Controlar cómo se compra cada montura](https://docs.getoptical.app/guias/evitar-compras-sin-configurar/)**.

Si aún estás eligiendo tema y ya sabes que quieres cerrar la compra directa, ten en cuenta que necesitarás poder **quitar el bloque de botones de compra** y **desactivar la barra fija** en una plantilla de producto propia. Casi todos los temas modernos lo permiten.

## Lista de comprobación

Antes de crear tu primer formulario:

- [ ] Sé qué productos se venden con formulario y cuáles no
- [ ] Los productos de mis extras están creados, con precio de **suplemento**
- [ ] Los que van incluidos existen a **0 €**
- [ ] Están en estado **No listado** (no en borrador ni sin publicar)
- [ ] La colección de monturas graduadas existe (si voy por colección)
- [ ] He decidido si mis monturas se pueden comprar sin configurar, y he aplicado esa decisión

Con eso hecho, montar el formulario es media hora. Sin eso, es media hora y volver atrás tres veces.

## Siguiente paso

[Instalar Optical Form](https://docs.getoptical.app/empezar/instalacion/) y después [Crear un formulario](https://docs.getoptical.app/guias/crear-formulario/).

---

# Instalar Optical Form

> Instala la app, activa la incrustación de la app y deja tu primer formulario listo en Shopify.

Source: https://docs.getoptical.app/empezar/instalacion/
Language: es

Optical Form se instala mediante una **incrustación de la app** en el tema — sin tocar código. La app incluye una **Guía de configuración** que te acompaña por estos pasos.

## 1. Instala la app

Instala **[Optical Form desde el Shopify App Store](https://apps.shopify.com/optical-form)**. Al abrirla por primera vez, la guía de configuración aparece en el Home.

**No hace falta elegir plan para empezar**

Desde el momento en que instalas tienes **14 días de bienvenida** con la app completa: puedes hacer todos los pasos de esta guía y publicar en tu tienda sin aprobar ningún cargo. Los **14 días de prueba** son otra cosa y empiezan cuando eliges plan. La cronología entera, en [Planes y facturación](https://docs.getoptical.app/facturacion/planes/#qué-pasa-desde-que-instalas).

## 2. Activa la incrustación de la app

1. En tu admin de Shopify: **Tienda online → Temas → Personalizar**.
2. Abre **Incrustaciones de aplicaciones** en el panel izquierdo.
3. Activa **Optical Form Drawer** y pulsa **Guardar**.

**Atajo**

La tarjeta **Activar la app** del Home abre el editor de temas directamente en la incrustación. Muestra **Publicada** cuando el panel está activo en tu tema publicado.

## 3. Añade el bloque a la página de producto

Este paso es el que hace aparecer el botón, y es distinto del anterior:

| | Qué hace | Dónde va |
|---|---|---|
| **Incrustación de la app** (paso 2) | Carga la app en la tienda | Toda la tienda, una vez |
| **Bloque "Optical Form"** (este paso) | **Dibuja el botón** | Dentro de la plantilla de producto |

Si activas solo la incrustación, el formulario existe pero **la página de producto no muestra nada**.

1. En el editor de temas, arriba, cambia la vista a **Producto** (plantilla de producto).
2. En la sección principal, pulsa **Añadir bloque** → elige **Optical Form**.
3. Colócalo donde quieras (normalmente junto al botón de añadir al carrito) y pulsa **Guardar**.

**Atajo**

El paso *"Añade el bloque a tu página de producto"* de la Guía de configuración abre el editor ya en la plantilla de producto y con el bloque preparado.

**Ojo al tema publicado**

La guía comprueba el **tema publicado**. Si añades el bloque a un borrador de tema, el paso seguirá marcado como pendiente hasta que publiques ese tema.

## 4. Ya tienes cuatro formularios de ejemplo

No empiezas de cero. Al instalar, la app deja **cuatro formularios en borrador** hechos y en el idioma de tu tienda:

- **Gafas graduadas a pantalla completa** — con colores de tratamiento de muestra.
- **Gafas graduadas** en panel lateral — con las ramas de monofocal, progresiva, lectura y sin graduar.
- **Gafas de sol** en modo oscuro.
- **Lentillas** — tipo de lentilla, graduación por ojo y complementos.

Están en **borrador**, así que no aparecen en ninguna página de producto hasta que tú los actives. Ábrelos, recórrelos y quédate con el que se parezca a lo que vendes: casi siempre sale más rápido que empezar en blanco.

Si prefieres partir de otra cosa, **Crear formulario** te ofrece cinco plantillas. Ver [Crear un formulario](https://docs.getoptical.app/guias/crear-formulario/).

## 5. Crea los productos de los complementos

Los tipos de lente, tratamientos y servicios se facturan como **productos reales de Shopify**. Créalos con el estado **No listado** —se pueden comprar pero no salen en colecciones ni en el buscador, ver [Antes de empezar](https://docs.getoptical.app/empezar/antes-de-empezar/#2-los-productos-de-tus-extras)— y luego vincúlalos a las opciones como [complementos](https://docs.getoptical.app/guias/accesorios-y-addons/).

## 6. Asigna el formulario a productos

En la pestaña **Productos** del formulario, elige en qué productos debe aparecer. En esas páginas el cliente verá el botón **"Configura tus lentes"** y seguirá el flujo multipaso.

Puedes elegir productos sueltos o **colecciones enteras**: con una colección, todos sus productos —también los que entren después— muestran el formulario, y da igual cuántos sean. Las reglas, en [Productos y colecciones](https://docs.getoptical.app/guias/productos-y-colecciones/).

## 7. Activa y sincroniza

Pon el formulario en estado **Activo** y pulsa **Sincronizar** para publicarlo en Shopify. Un formulario solo aparece en la tienda si está **Activo + Sincronizado**. Ver [Sincronización](https://docs.getoptical.app/guias/sincronizacion/).

## 8. Decide cómo se compra cada montura

Queda una decisión, y es de negocio: tu tema conserva **sus propios botones de compra**, así que hoy un cliente puede llevarse la montura **sin lentes**. Si vendes también monturas sueltas, eso es justo lo que quieres. Si no, ese pedido entra pagado y sin graduación, y lo descubres en el taller.

Tómala ahora, no después: [Controlar cómo se compra cada montura](https://docs.getoptical.app/guias/evitar-compras-sin-configurar/).

## Siguiente paso

Repasa los [Conceptos clave](https://docs.getoptical.app/empezar/conceptos/) o pasa directo a [Crear un formulario](https://docs.getoptical.app/guias/crear-formulario/).

¿Algo no sale como esperabas? [Cuando algo no funciona](https://docs.getoptical.app/guias/cuando-algo-no-funciona/).

---

# Conceptos clave

> El vocabulario de Optical Form — formulario, paso, opción, complemento, accesorio y bundle.

Source: https://docs.getoptical.app/empezar/conceptos/
Language: es

Antes de construir, conviene conocer las piezas que usa Optical Form. Todas aparecen con estos nombres en el panel de la app.

## Formulario

Un **flujo multipaso** que el cliente completa en la página de producto. Tiene un **nombre**, un **estado** (Borrador / Activo / Archivado) y una lista de **pasos**. Se asigna a uno o más productos y se publica en Shopify mediante sincronización.

## Paso

Cada **paso** hace una pregunta al cliente (tipo de lente, material, graduación, accesorios…). Tiene un **Tipo de entrada** que decide cómo se muestra. Ver [Crear un formulario](https://docs.getoptical.app/guias/crear-formulario/) para la lista completa de tipos.

## Opción

Dentro de un paso de selección, cada **opción** es una tarjeta elegible (ej. "Progresivo", "Antirreflejante"). Una opción puede llevar: una **etiqueta**, una **imagen**, un **distintivo informativo** (solo visual), incompatibilidades con otras opciones, un **salto** a otro paso y uno o varios **complementos**.

## Complemento

Un **producto de Shopify vinculado a una opción** que se factura como **línea separada** en el carrito cuando el cliente elige esa opción (ej. el propio tipo de lente, un tratamiento, un servicio de montaje). Se agrupan bajo el producto principal como un bundle.

## Colores seleccionables

Una **fila de muestras de color** dentro de una opción (tintes, polarizadas, fotocromáticas). El cliente elige un color y **solo ese** se cobra: cada color es una variante de un producto tuyo, y varios productos forman grupos con título (Classic, Fashion, Gradient…). Ver [Colores seleccionables](https://docs.getoptical.app/guias/accesorios-y-addons/#colores-seleccionables-por-opción).

## Plantilla de diseño

Un aspecto completo del panel en un clic — **Clásica**, **Moderna** u **Oscura** — desde la pestaña Diseño. Distinta de la plantilla de **formulario** (los pasos con los que nace un formulario nuevo) y de la plantilla de **producto** de tu tema. Ver [Diseño y carrito](https://docs.getoptical.app/guias/diseno-y-carrito/#plantilla-de-diseño).

## Accesorio (cross-sell)

Un paso de tipo **Accesorios** ofrece productos extra opcionales (estuches, limpiadores, cordones…) que el cliente puede añadir o saltar. A diferencia de los complementos, viven en su propio paso y no dependen de una opción concreta.

## Bundle

El **conjunto** producto principal + complementos + accesorios que se añade al carrito en un clic. Shopify los enlaza de forma nativa con `parent_id`, así que se borran en cascada y se leen juntos en el checkout y en los emails de pedido. Ver [Diseño y carrito](https://docs.getoptical.app/guias/diseno-y-carrito/).

## Graduación (Rx)

Los datos de la receta del cliente: esfera (SPH/PWR), cilindro (CYL), eje (AX), adición (ADD) y distancia interpupilar (DP), por cada ojo (OD / OI). Ver [Graduación y receta](https://docs.getoptical.app/guias/graduacion/).

## Metaobject / Sincronización

Cada formulario se **publica en Shopify como un metaobject**. Guardar en la app no basta: hay que **Sincronizar** para que los cambios lleguen a la tienda. Ver [Sincronización](https://docs.getoptical.app/guias/sincronizacion/).

---

# Crear un formulario

> Configura los pasos de tu configurador de graduación y asígnalo a un producto.

Source: https://docs.getoptical.app/guias/crear-formulario/
Language: es

Un formulario de Optical Form es un **flujo multipaso** que el cliente completa en la página de producto.

**Antes de empezar**

Si aún no has creado los productos de tus tratamientos y tipos de lente, hazlo primero: los necesitas para vincular los complementos. Ver [Antes de empezar](https://docs.getoptical.app/empezar/antes-de-empezar/).

## Los cuatro formularios que ya tienes

Al instalar te dejamos **cuatro formularios de ejemplo ya montados**, todos en **Borrador**: **gafas graduadas a pantalla completa** (con colores de tratamiento de muestra), **gafas graduadas** en panel lateral, **gafas de sol en modo oscuro** y **lentillas**. No están asignados a ningún producto, así que no se ven en tu tienda hasta que tú quieras.

**Empieza por uno de ellos, no por uno en blanco.** Traen los pasos, los textos y el diseño ya hechos, y se editan enteros — es mucho más rápido que armar el tuyo desde cero.

## Pasarlo a Activo

Un formulario en **Borrador** no lo ve nadie. Para publicarlo:

1. **Formularios** → entra en el que quieras usar.
2. En la pestaña **Ajustes**, cambia **Estado** de **Borrador** a **Activo**.
3. **Guarda** y luego **Sincroniza** — ver [Sincronización](https://docs.getoptical.app/guias/sincronizacion/).

Para que aparezca de verdad hacen falta las cuatro cosas a la vez: **Activo**, **Sincronizado**, **asignado a un producto** y la [incrustación de la app](https://docs.getoptical.app/empezar/instalacion/) activada en tu tema.

## Crear el formulario

1. En la app: **Formularios → Crear formulario**.
2. Elige una **plantilla** de inicio o empieza en blanco:
   - **Gafas graduadas** — tipo de lente → material → tratamiento → graduación → resumen.
   - **Gafas graduadas · Pantalla completa** — el mismo flujo a pantalla partida y con colores seleccionables en los tratamientos.
   - **Lentillas** — pack, graduación por ojo tomada del catálogo de fabricación del producto y líquidos de mantenimiento.
   - **Gafas de sol · Oscuro** — solo sol o graduadas → graduación → tinte → polarización → accesorios. Nace con la plantilla de diseño **Oscura** (fondo carbón, acento bermellón) y con iconos dibujados para fondo oscuro: un configurador que parece parte del producto. Pensada para gafas de sol y monturas premium.
   - **Formulario en blanco** — un paso vacío para construir desde cero.
3. Ponle nombre, elige el estado (Borrador / Activo) y crea.

## Tipos de paso

En la pestaña **Pasos**, cada paso tiene un **Tipo de entrada** que define cómo se muestra:

| Tipo de entrada | Para qué sirve |
|---|---|
| **Selección única** | Elegir una opción (tipo de lente, tratamiento). |
| **Selección múltiple** | Elegir varias (filtros o tratamientos combinables). Para que el cliente vea que puede seguir añadiendo, eliges entre una casilla en cada opción o un aviso sobre el botón de continuar. |
| **Graduación (Rx)** | Captura por ojo (OD/OI): SPH, CYL, AX, ADD y DP. Ver [Graduación](https://docs.getoptical.app/guias/graduacion/). |
| **Receta de lectura (rejilla)** | Rejilla de ampliación para lentes de lectura. |
| **Subida de archivo** | El cliente sube su receta (imagen o PDF). Ver [Subida de archivo](https://docs.getoptical.app/guias/subir-receta/). |
| **Campo de texto** | Nota libre del cliente. |
| **Accesorios (cross-sell)** | Añadir productos extra al pedido. Ver [Complementos y accesorios](https://docs.getoptical.app/guias/accesorios-y-addons/). |
| **Resumen de graduación** | Muestra la graduación introducida antes de finalizar. |
| **Lentillas** | Pack por ojo, graduación leída del catálogo de fabricación del producto y referencia exacta del fabricante en el pedido. |
| **Variantes del producto** | Deja elegir la variante dentro del formulario. Se oculta solo si el producto tiene una única variante. |

## Ajustes de un paso

Cada paso tiene: **ID interno** (no visible al cliente), **Título**, **Descripción**, **Tipo de entrada** y varios interruptores:

- **Obligatorio** — el cliente debe completar el paso para avanzar.
- **Ocultar del resumen** — no muestra la selección en el resumen ni en las etiquetas del pie (útil para pasos que solo dirigen al cliente).
- **Mostrar 0 en vez de "Incluido"** — muestra `€0,00` en las opciones sin coste, en lugar de la etiqueta "Incluido".
- **Precio que se muestra en las opciones** — qué importe enseña cada tarjeta del paso: solo el coste añadido («+25 €», por defecto), un precio de partida, el precio total o solo el precio de la opción. Cada opción puede llevar el suyo con **Precio que se muestra en esta opción**. Los cuatro modos, con un ejemplo, en [Precios y cobro](https://docs.getoptical.app/guias/precios-y-cobro/#el-precio-de-cada-tarjeta-cuatro-modos).
- **Si este paso solo tiene una opción, elegirla y saltar el paso** — desactivada por defecto, solo en pasos de elección única. Activada, cuando a un producto le queda una sola opción en ese paso (un único pack, un único tratamiento posible), la app la elige por el cliente, la lleva al pedido con su etiqueta y pasa directamente al siguiente paso: nadie ve una pantalla con una sola tarjeta. No salta si la opción lleva colores seleccionables o una acción externa, ni si el salto terminaría el formulario. Desactivada, un paso de una sola opción se muestra tal cual — a veces esa pantalla está a propósito.

## Anatomía de una opción

En los pasos de selección, cada **opción** puede llevar:

- **Etiqueta**, **descripción** e **imagen** (de tus Shopify Files o por URL).
- **Ventajas** — hasta cuatro etiquetas cortas bajo la descripción ("Menos reflejos", "Para pantallas") que dicen qué gana el cliente eligiendo esa opción. No cambian el precio ni llegan al pedido. Las del catálogo se traducen solas al idioma del cliente; las que escribas tú las traduces como cualquier otro campo.
- **Texto de ayuda** — opcional. Si lo rellenas, aparece un «?» junto al título de la opción que el cliente abre para leer una explicación más larga (al pasar el ratón o pulsándolo), así la descripción puede quedarse corta. Se traduce como cualquier otro campo; su aspecto se ajusta en [Diseño › Ayuda emergente](https://docs.getoptical.app/guias/diseno-y-carrito/).
- **Distintivo informativo** — texto visual (ej. `+250`) que **no** afecta al total. Si pones ahí un precio y no vinculas un complemento, el cliente lo ve pero **no lo paga**: ver [Precios y cobro](https://docs.getoptical.app/guias/precios-y-cobro/). Solo se ve en opciones que no suman nada al precio: en una opción con complemento manda el modo de precio que hayas elegido. Para etiquetas como «Mejor precio» usa la **Etiqueta de la opción** (abajo); si ya tenías escrito algo como «Mejor precio • 59 €» en una opción que cuesta 59 €, la app lo muestra como etiqueta sin que hagas nada.
- **Etiqueta de la opción** — una etiqueta junto al título de la opción: «Recomendada», «Mejor precio», «Más popular»… Pulsa **Elegir etiqueta** y elige una prediseñada (se traduce sola al idioma del cliente y tiene su color) o escribe la tuya y elígele el color. Una por opción, en cualquier paso de opciones. No la elige por el cliente ni cambia el orden: si quieres que salga primera, arrástrala. El texto de «Recomendada» se cambia en [Diseño › Textos](https://docs.getoptical.app/guias/diseno-y-carrito/).
- **Incompatible con** — impide combinarla con otras opciones.
- **Siguiente paso (al hacer clic)** — secuencial, saltar a un paso concreto, o **Enviar (fin)**.
- **Complementos** — productos de Shopify que se facturan como líneas separadas al elegir la opción.
- **Colores seleccionables** — una fila de muestras (tintes, polarizadas, fotocromáticas): el cliente elige un color y **solo ese** se cobra. Cada color es una variante de un producto tuyo; varios productos forman grupos con título. Ver [Colores seleccionables](https://docs.getoptical.app/guias/accesorios-y-addons/#colores-seleccionables-por-opción).
- **Acción externa** — sustituye el "añadir al carrito" por un mensaje + botón (cita, WhatsApp, solo en tienda).

Ver [Complementos, accesorios y acciones externas](https://docs.getoptical.app/guias/accesorios-y-addons/).

## Ramificación condicional

El campo **Siguiente paso** de cada opción define a qué paso salta el flujo — así "Gafas graduadas" y "Gafas de lectura" pueden llevar por caminos distintos desde el mismo primer paso. El diagrama de flujo del editor visualiza todos los saltos.

## Asignar y diseñar

- **Productos** — asigna el formulario a productos sueltos o a colecciones enteras. Qué gana cuando se solapan y qué pasa con colecciones grandes: [Productos y colecciones](https://docs.getoptical.app/guias/productos-y-colecciones/).
- **Diseño** — colores, tipografía y qué datos se muestran en el carrito. Ver [Diseño y carrito](https://docs.getoptical.app/guias/diseno-y-carrito/).
- **Sincronizar** — publica los cambios en la tienda. Ver [Sincronización](https://docs.getoptical.app/guias/sincronizacion/).

**Un producto, un formulario**

Un formulario puede llevar tantos productos como quieras, pero **cada producto admite un solo formulario**. Si asignas aquí un producto que ya estaba en otro, **se lo lleva este** — sin avisarte y sin preguntar: el formulario anterior lo pierde en silencio.

Antes de mover productos entre formularios, comprueba en cuál están. Y si lo que quieres es que la montura se venda también **sin** configurar, no hace falta otro formulario ni otro producto: el botón de tu tema sigue ahí ([Controlar cómo se compra cada montura](https://docs.getoptical.app/guias/evitar-compras-sin-configurar/)). Solo dos **formularios** distintos sobre la misma montura exigen dos productos.

---

# Productos y colecciones

> Las dos formas de decir en qué productos aparece un formulario, qué gana cuando se solapan y qué pasa con colecciones de muchos productos.

Source: https://docs.getoptical.app/guias/productos-y-colecciones/
Language: es

Un formulario aparece en una página de producto solo si se lo has asignado. Hay **dos formas** de hacerlo, y conviven: producto a producto, o por colección. Las dos viven en la pestaña **Productos** del formulario.

## Producto a producto

Pulsa **Añadir productos**, elige en el selector de Shopify los que quieras y listo. Cada producto elegido queda vinculado a este formulario, y la lista de la tarjeta **Productos asignados** te enseña exactamente cuáles son.

- **Cada producto admite un solo formulario.** Si eliges uno que ya estaba en otro formulario, se lo lleva este, sin preguntar. Antes de mover productos, comprueba en cuál están.
- **Cada producto tarda unos segundos**, y se procesan uno detrás de otro: la app tiene que escribir en Shopify por cada uno. Diez productos son cosa de un minuto; cien, unos diez minutos con la pestaña abierta. Si vas a asignar muchos, hazlo por colección.

## Por colección

Pulsa **Añadir colección** y elige una. A partir de ese momento **todos los productos de esa colección muestran el formulario**, incluidos los que entren en la colección más adelante, ya sea porque los añades a mano o porque una colección automática los capta por sus reglas.

Esto funciona porque la app no toca los productos: apunta el formulario **en la colección**, y la página de producto mira en qué colecciones está cuando se carga. Por eso:

- **Da igual cuántos productos tenga la colección.** Asignar una colección de 5 productos y una de 5.000 cuesta lo mismo y tarda lo mismo: un par de segundos.
- **Quitar la colección** deshace la asignación de golpe para todos sus productos, en la siguiente carga de cada página de producto.
- La tarjeta **Productos asignados** no lista los productos que llegan por colección: solo los que asignaste uno a uno. El contador de la pestaña te dice cuántas colecciones tiene el formulario.

**La colección tiene que estar publicada en Tienda online**

La página de producto solo ve las colecciones disponibles en el canal **Tienda online**. Una colección sin publicar en ese canal no muestra el formulario a sus productos aunque la hayas asignado. Si un producto de una colección asignada no enseña el botón, mira eso primero.

## Qué gana cuando se solapan

Un producto puede estar asignado directamente y, además, pertenecer a una o varias colecciones asignadas. La regla es fija:

1. **La asignación directa del producto gana siempre.** Si un producto está en una colección asignada al formulario A pero tú lo asignaste a mano al formulario B, muestra B.
2. Si no tiene asignación directa, muestra el formulario de **la primera de sus colecciones asignadas**. Cuando un producto está en dos colecciones asignadas a formularios distintos, ese orden lo decide Shopify, no la app, así que no cuentes con él.

En la práctica: usa las colecciones para el grueso del catálogo, y la asignación directa para las excepciones — la montura que necesita otro formulario, o el producto que quieres sacar de la regla general.

## Lo que no cambia

- El formulario tiene que estar **Activo y sincronizado** para aparecer, se asigne como se asigne. Al asignar una colección, la app sincroniza el formulario si hacía falta.
- Los productos sin asignación no muestran el botón, pero tu tema conserva **sus propios botones de compra**. Cómo tratar eso es una decisión tuya: [Controlar cómo se compra cada montura](https://docs.getoptical.app/guias/evitar-compras-sin-configurar/).
- Si borras un formulario, sus asignaciones —productos y colecciones— se limpian con él.

---

# Controlar cómo se compra cada montura

> Tu tema trae sus propios botones de compra. Decide si esa montura se puede llevar sin lentes, y aplica tu decisión en la página de producto, en la barra fija y en los listados.

Source: https://docs.getoptical.app/guias/evitar-compras-sin-configurar/
Language: es

Antes de tocar nada, una decisión que es tuya: **esa montura, ¿se puede comprar sin lentes?**

Las dos respuestas son válidas, y hay ópticas funcionando con cada una. La app no tiene opinión sobre esto: te deja las dos vías abiertas y eliges tú, producto a producto.

| | Cuándo tiene sentido |
|---|---|
| **Solo configurada** | Lo más habitual. La montura se vende con su graduación y nunca suelta |
| **Las dos cosas, a la vez** | Vendes también monturas sueltas, a otros profesionales o a clientes que se pondrán las lentes en su óptica de siempre |

Lo único que no conviene es no haberlo decidido, porque entonces lo decide tu tema por ti. Esta página te enseña a ver qué hace hoy tu página de producto, y a dejarla como tú quieras.

## Los dos caminos de compra

Optical Form añade **su** botón a la página de producto. Los botones de tu tema **siguen ahí**, y hacen algo distinto:

| | Qué hace |
|---|---|
| **Botón de Optical Form** | Abre el formulario, recoge la graduación, añade montura + lentes + tratamientos |
| **Botón de tu tema** | Añade la montura y ya está |

La app **no borra los botones de tu tema**, y es a propósito. En tu catálogo casi seguro hay productos que se venden tal cual —estuches, líquidos, accesorios, gafas de sol sin graduar— y esos **necesitan** su botón de siempre. Quitarlo por nuestra cuenta rompería media tienda.

## La prueba de 30 segundos

Sirve para las dos decisiones, porque no supone nada: solo te dice qué hace hoy tu página de producto.

1. Abre una página de producto que use formulario, **como si fueras un cliente**.
2. **No toques** el botón de Optical Form.
3. Intenta comprar la montura por cualquier otra vía.

- **Si lo consigues y querías que se pudiera** — ya está, tienes los dos caminos abiertos. Salta a [Si quieres los dos botones](#si-quieres-los-dos-botones), que hay un detalle de claridad que sí conviene cuidar.
- **Si lo consigues y no querías** — sigue leyendo. Hay tres sitios por donde se entra, y normalmente solo se cierra el primero.

**Si tu decisión es «solo configurada», tómala antes de abrir**

Un pedido que entra por el botón del tema **parece perfectamente normal**: se paga, aparece en tu panel, el cliente recibe su confirmación. Que le falta la receta se descubre en el taller, días después, con el dinero ya cobrado y el cliente esperando sus gafas.

No es que se rompa nada — es que ese pedido no lleva lo que hace falta para fabricar. Por eso conviene hacer esta prueba **antes** de abrir la tienda al público, y no cuando ya está entrando gente.

## Dónde están los botones de compra directa

Son tres, y vienen activos por defecto en la mayoría de temas modernos. Conviene saber dónde están, hayas decidido lo que hayas decidido:

**1. El botón de compra de la página de producto**
El "Añadir al carrito" de toda la vida, junto al precio y al selector de variantes.

**2. La barra que aparece al bajar**
El más fácil de pasar por alto, porque **no se ve al cargar la página**. Baja del todo en la página de producto: en muchos temas aparece una barra fija abajo con la foto, el precio y un botón de compra. En **Horizon viene activada por defecto**.

**3. La compra rápida de los listados**
En las páginas de colección, muchas tarjetas de producto traen un botón para añadir sin entrar en la página de producto. Ahí el cliente ni llega a ver tu formulario.

**Los tres son puertas distintas**

Cerrar solo el primero es lo que suele pasar. Si tu decisión es que la montura no se venda suelta, los otros dos la siguen vendiendo.

## Si quieres que esa montura solo se venda configurada

La idea es sencilla: **una plantilla de producto aparte**, sin botones nativos, que uses únicamente en los productos que llevan formulario. El resto de tu catálogo se queda como está.

### Paso 1 — Crea la plantilla

1. **Tienda online → Temas → Personalizar**.
2. Arriba, en el selector de plantilla, elige **Producto**.
3. Despliega el selector y pulsa **Crear plantilla**.
4. Ponle un nombre reconocible, por ejemplo `graduadas`. Créala **a partir de** la plantilla de producto que ya usas.

### Paso 2 — Quita las vías de compra directa

Con la plantilla nueva abierta:

- Selecciona el bloque de **botones de compra** y **quítalo** (o desactívalo con el icono del ojo).
- En los **ajustes de la sección** de producto, busca la opción de **barra de compra fija** (en Horizon, *Sticky add to cart*) y **desactívala**.
- Deja el bloque de **Optical Form**, que es el que ahora lleva toda la venta.

Guarda.

### Paso 3 — Asigna la plantilla a tus monturas

En **Productos**, abre cada montura que use formulario y, en la barra lateral derecha, en **Plantilla de tema**, elige `graduadas`. Guarda.

Puedes hacerlo en lote: selecciona varios productos → **Acciones** → cambiar plantilla.

### Paso 4 — La compra rápida de los listados

Esta vive en las **colecciones**, no en la página de producto. En el editor, ve a la plantilla de colección y **desactiva el botón de compra rápida** de las tarjetas.

Si tu tema no deja desactivarlo solo para algunos productos, tendrás que desactivarlo entero, y eso afecta también a los productos que sí se venden sueltos. Es el punto donde más merece la pena parar a valorar: cuánto te aporta ese atajo, frente a cuántas monturas sin graduar se colarían por ahí.

### Paso 5 — Repite la prueba de 30 segundos

Vuelve a intentar comprar sin abrir el formulario. Ahora no deberías poder — ni en la página de producto, ni al bajar, ni desde la colección.

### Compruébalo antes de abrir al público

- [ ] La plantilla nueva no tiene botón de compra en la página de producto
- [ ] La barra fija al bajar está desactivada
- [ ] Las tarjetas de colección no permiten compra rápida
- [ ] Todas las monturas con formulario usan esa plantilla
- [ ] Has intentado comprar sin configurar **y no has podido**
- [ ] Un pedido de prueba llega con la graduación en las propiedades de la línea

Cuando las seis estén marcadas, esa montura solo se vende configurada.

## Si quieres los dos botones

No hay que hacer nada especial: es el estado por defecto. El botón de tu tema y el de Optical Form conviven en la misma página de producto, y el cliente elige.

Lo único que pide esto es **que se entienda cuál hace qué**. Dos botones seguidos que ponen los dos "Añadir al carrito" son una trampa: el cliente pulsa el primero que ve y se lleva una montura pelada creyendo que ha comprado gafas. Eso acaba en devolución, y la devolución es tuya.

- **Ponle nombre al de Optical Form.** En **Tienda online → Temas → Personalizar**, pulsa el bloque **Optical Form** y escribe en *Texto del botón* algo que diga lo que hace: «Configurar con mi graduación», «Añadir lentes graduadas». Ver [El botón del producto](https://docs.getoptical.app/guias/boton-del-producto/).
- **Ponle nombre también al de tu tema**, desde los ajustes de tu tema: «Comprar solo la montura».
- **Que destaque el que quieres que gane.** Si tu venta principal es la graduada, que ese sea el botón de color y el otro más discreto.

**Si vendes en varios idiomas**

Si escribes un texto propio en *Texto del botón*, **ese texto sale igual en todos los idiomas**: deja de traducirse solo. Con una tienda en un idioma da igual; con varios, o lo traduces tú desde el editor de cada idioma, o dejas el campo vacío y usas el texto de la app. Ver [Idiomas y textos](https://docs.getoptical.app/guias/traducciones/).

Y aun con los dos botones, plantéate quitar la **compra rápida de los listados**: ahí el cliente no ve los dos botones ni la diferencia entre ellos, así que la elección que le ofreces no llega a existir.

## Cómo hago…

**…si vendo las mismas monturas con y sin graduación**
Tienes dos formas, y la buena depende de cómo quieras que se vea:

- **Un solo producto con los dos botones** — lo de la sección de arriba. El cliente ve una página de producto y elige ahí mismo. Es lo más directo y lo que menos catálogo te crea.
- **Dos productos distintos** — uno con la plantilla `graduadas` y formulario, otro normal. Es más trabajo, pero te deja poner precios, fotos y textos distintos, y salen por separado en las colecciones y en el buscador.

**…si mi tema no me deja quitar el botón de compra**
Algunos temas no permiten eliminar ese bloque. Entonces la vía es el campo **Custom CSS** de la incrustación de la app, ocultándolo solo en esa plantilla. Escríbenos y te pasamos la regla para tu tema.

**…si quiero comprobarlo sin publicar**
Duplica el tema, haz los cambios en la copia y previsualízala. Recuerda que la Guía de configuración de la app mira **el tema publicado**, así que los pasos de la incrustación y del bloque seguirán marcados sobre el que tengas en vivo.

---

# Graduación y receta

> Qué significa cada valor de una receta, cómo se captura por ojo y cómo llega al pedido para tu laboratorio.

Source: https://docs.getoptical.app/guias/graduacion/
Language: es

Si vienes de Shopify y no de la óptica, empieza por el glosario. Configurar bien este paso es mucho más fácil cuando sabes qué le estás pidiendo al cliente.

## Glosario: qué es cada valor

Una receta de gafas es una lista de números, uno por cada ojo. Esto es lo que significan:

| Abreviatura | Nombre | Para qué sirve |
|---|---|---|
| **OD** | Ojo derecho | Del latín *oculus dexter*. Es el derecho en cualquier país |
| **OI** / **OS** | Ojo izquierdo | En español **OI**; en inglés se escribe **OS** (*oculus sinister*) |
| **ESF** / **SPH** | Esfera | La corrección principal. **Negativa** para miopía (ve mal de lejos), **positiva** para hipermetropía (ve mal de cerca) |
| **CIL** / **CYL** | Cilindro | Corrige el astigmatismo: la córnea no es del todo redonda y la imagen sale deformada. Suele ser negativo, y puede ser 0 |
| **EJE** / **AX** | Eje | En qué ángulo va colocado ese cilindro, de 0 a 180 grados. Solo tiene sentido si hay cilindro |
| **ADD** | Adición | Potencia extra para ver de cerca. Aparece en progresivas y bifocales, a partir de los cuarenta y pico. Siempre positiva |
| **DIP** / **PD** | Distancia interpupilar | Los milímetros entre el centro de una pupila y la otra. Sirve para centrar las lentes delante de los ojos. En adultos suele estar entre 54 y 74 mm |

Las dioptrías se miden de 0,25 en 0,25. Por eso los desplegables saltan así: `-1.00`, `-1.25`, `-1.50`…

**Por qué importa que el cliente lo copie bien**

Estos números se fabrican tal cual. Un cliente que se equivoca de signo, o que cambia el ojo derecho por el izquierdo, recibe unas gafas con las que no ve. Por eso conviene incluir un paso de resumen para que confirme antes de pagar.

## Los dos tipos de paso

- **Graduación (Rx)** — receta completa, con todos los valores de arriba. Para gafas graduadas de verdad.
- **Receta de lectura (rejilla)** — solo una ampliación (`+1.00`, `+1.50`…). Para gafas de lectura premontadas, las que se venden ya hechas y no llevan receta.

## Paso Graduación (Rx)

Captura los valores de cada ojo: **OD** (derecho) y **OI** (izquierdo).

### Rangos de cada campo

Cada campo tiene **Mín**, **Máx** y **Paso** configurables. Ajústalos a lo que tu laboratorio pueda fabricar: si no trabajas graduaciones por debajo de -8, ponlo de mínimo y el cliente no podrá pedirlas.

- **Mostrar campo ADD** — actívalo solo si vendes progresivas o bifocales. En gafas normales sobra y confunde.

### El eje se activa con el cilindro

Los tres valores de cada ojo —esfera, cilindro y eje— arrancan **vacíos**. No en `0.00`: un cero es un valor clínico real, quiere decir «sin astigmatismo», y no puede confundirse con «esto todavía no lo he rellenado».

El campo de **eje** arranca además **desactivado**, en gris y sin poder tocarse. Se activa solo cuando el cliente escribe un cilindro distinto de cero, porque un eje sin cilindro no significa nada: es el ángulo de algo que no existe. Si el cliente vuelve atrás y quita el cilindro, el eje se vacía y se desactiva otra vez.

Y al revés: **si hay cilindro, el eje es obligatorio.** La app no deja pasar de paso hasta que se rellene.

**El cilindro también puede venir en positivo**

En España las recetas suelen traer el cilindro en negativo, pero buena parte de Europa lo escribe en positivo, y las dos notaciones son igual de válidas. El eje se activa con **cualquier** cilindro distinto de cero, tenga el signo que tenga.

Esto no se configura en ninguna parte: funciona así siempre, en todos los formularios.

### Distancia interpupilar

- **Mostrar DIP** — añade la captura de la distancia interpupilar.
- **Cómo la introduce el cliente** — *campo libre* (escribe el número; es lo de siempre) o *desplegable con los valores admitidos*. El desplegable evita erratas y valores que tu laboratorio no fabrica; el campo libre es más rápido para quien se sabe su DIP. Empieza en «—»: nadie tiene una DIP por defecto.
- **Rangos en mm** — el valor único (por defecto 40 a 85, de 0,5 en 0,5) y el valor por ojo (20 a 45). Son a la vez lo que ofrece el desplegable y lo que acepta el campo libre: un cliente que escriba 6 en vez de 63 recibe un aviso, no un pedido imposible.
- **DIP único o por ojo** — un solo número (lo habitual), o uno por ojo. El cliente lo cambia con un interruptor.
- **Mensajes de validación** — qué se le dice si lo deja vacío.

**Por defecto, lo sencillo**

El interruptor de DIP por ojo arranca **desactivado**: el cliente escribe un único número salvo que lo active. La mayoría de recetas traen un solo valor, así que el caso común queda con menos fricción.

### El cliente tiene ayuda en cada campo

Tu cliente no es óptico. Tiene la receta en la mano y no sabe qué es un cilindro, ni si el eje va con signo, ni cuál de los números es la distancia interpupilar. Por eso cada campo del paso lleva un pequeño **«?»** a la derecha de su etiqueta —ESF, CIL, EJE, ADD y el título de la DIP— que al pasar el ratón, tocarlo o llegar con el teclado abre una explicación corta, en palabras llanas: qué es ese valor, qué signo lleva y dónde encontrarlo en la receta.

Viene activado en todos los formularios, con textos ya escritos en el idioma de tu tienda. No tienes que hacer nada.

Lo que sí puedes hacer:

- **Desactivarlo** — en la configuración del paso, desmarca *Mostrar un icono de ayuda junto a cada campo de la receta*. Desaparecen los cinco «?» a la vez.
- **Reescribir los textos** — en *Etiquetas y traducciones* del mismo paso, bajo *Textos de ayuda*. Cada campo aparece vacío con el texto por defecto **en gris, en el idioma de tu tienda** — el mismo que lee tu cliente. Escribe encima si quieres decirlo a tu manera —por ejemplo, con la notación que usa tu laboratorio— y **si vacías el campo, vuelve al texto por defecto** (cómo funciona, en [Idiomas y textos](https://docs.getoptical.app/guias/traducciones/)). Los textos de ADD y DIP solo aparecen si tienes esos campos activos.
- **Traducirlos** — como el resto de etiquetas, desde la pestaña de cada idioma. Ver [Idiomas y textos](https://docs.getoptical.app/guias/traducciones/).

Los «?» usan los mismos ajustes de color, tamaño y fondo que los de las opciones del formulario. Se cambian en [Diseño y carrito](https://docs.getoptical.app/guias/diseno-y-carrito/), sección *Ayuda emergente*.

### Y una receta de ejemplo

Arriba a la derecha del paso hay un enlace, **«¿Cómo leer tu receta?»**, que abre una receta de ejemplo montada con **tus propias etiquetas**: dos ojos con ESF, CIL y EJE (y ADD si lo tienes activo), y la DIP debajo. El cliente toca una columna y la app la resalta y le explica ese valor con el mismo texto de ayuda del «?» correspondiente. Es lo que más ayuda a quien tiene la receta en papel delante: ve dónde está cada número en un ejemplo que se parece al suyo.

Viene activado. Se desactiva en la configuración del paso (*Mostrar un enlace «¿Cómo leer tu receta?»…*), y el texto del enlace, el título sobre el ejemplo y el texto de ayuda de debajo se reescriben en *Etiquetas y traducciones*, bajo *Guía con receta de ejemplo*. Las explicaciones son las mismas de los «?»: si cambias una, cambia en los dos sitios.

### Cambiar las etiquetas

Todo el texto del paso se puede reescribir sin tocar código. Antes de hacerlo lee **[Idiomas y textos](https://docs.getoptical.app/guias/traducciones/)**: los campos vienen rellenos en inglés y eso tiene truco.

## Paso Resumen de graduación

Muestra al cliente la receta que acaba de introducir **antes** de añadir al carrito: una tabla con tus etiquetas de cabecera (ESF, CIL, EJE y ADD si la hay), una fila por ojo y la DIP debajo — el mismo dibujo que la receta de ejemplo del paso anterior, para que no tenga que adivinar en qué orden van los números.

Ponlo siempre que captures recetas completas. Es la última oportunidad de que el cliente detecte un error suyo, y te ahorra devoluciones.

Si el cliente **subió una foto** de su receta en vez de teclearla, el resumen le enseña **la imagen**, no solo el nombre del archivo. Es la diferencia entre confirmar `receta.png` y confirmar los números que se van a fabricar: un archivo equivocado —el recibo del gimnasio, una captura de otra cosa— se ve al instante. Si lo que subió es un **PDF**, que no se puede dibujar, aparece un icono de documento con el nombre y el peso.

## Paso Receta de lectura (rejilla)

Para gafas de lectura premontadas, donde el cliente solo elige una ampliación.

- **Valor mínimo**, **máximo**, **paso** y **columnas** de la cuadrícula.
- **Prefijo del valor** — normalmente `+`, para que se lea `+1.50`.
- Vista previa en vivo de cuántos valores genera.

## Cómo llega la receta al pedido

Cuando el cliente añade al carrito, la receta viaja **dentro del pedido de Shopify**, junto al producto. La ves en el detalle del pedido, en tu admin de siempre, y viaja también a lo que mandes a tu laboratorio.

Se escribe una línea por ojo, con cada valor **precedido de la etiqueta de su campo** —las tuyas, en el idioma del cliente— para que cualquiera la lea sin saber en qué orden van los números:

```
Tipo de gafas: Gafas graduadas
Tipo de lente: Lentes finas estándar
OD: ESF -2.50 · CIL -1.25 · EJE 90° · ADD +1.50
OI: ESF -3.00 · CIL 0.00 · EJE — · ADD +2.00
DIP: 63
```

Un ojo sin cilindro no lleva eje: se imprime `EJE —`, igual que la adición cuando solo la lleva un ojo — nunca un `0°` inventado que un óptico leería como un eje real. Es la misma línea que ve el cliente en el carrito, en el checkout y en el correo de confirmación.

Si tienes una integración con tu software de gestión, la misma receta viaja además en la propiedad oculta que acordaste con él, con el formato que ese software espera (ahí un eje vacío sí va como `0`, porque es lo que pide su contrato). Ver [Integración](https://docs.getoptical.app/desarrolladores/integracion/).

**La receta no se puede quitar del pedido**

Hay una casilla para excluir pasos del carrito, pero **no aparece en los pasos que llevan la receta** ni en la subida de foto. Un pedido de gafas graduadas sin graduación no se puede fabricar, así que la app no te deja llegar a esa situación ni por error.

Lo que sí decides es si el **cliente** ve esos valores. Mira [Diseño y carrito](https://docs.getoptical.app/guias/diseno-y-carrito/).

Si el cliente sube una foto de su receta en vez de teclearla, en el pedido aparece el nombre del archivo. Ver [Subir la receta](https://docs.getoptical.app/guias/subir-receta/).

---

# Subida de archivo

> Deja que el cliente adjunte su receta como imagen o PDF.

Source: https://docs.getoptical.app/guias/subir-receta/
Language: es

El paso **Subida de archivo** permite al cliente adjuntar su receta (foto o PDF) en lugar de escribir los valores a mano. Ideal como alternativa al paso de [Graduación](https://docs.getoptical.app/guias/graduacion/) o como complemento.

## Configuración

- **Tipos de archivo aceptados** — extensiones separadas por coma, ej. `.jpg,.png,.pdf`.
- **Tamaño máximo (MB)** — límite de peso del archivo.

## Zona de subida

Todo el texto es editable: el texto principal de la zona de arrastre, el texto secundario (hint), el botón de explorar, y los textos del estado con archivo seleccionado (**Cambiar archivo** / **Quitar archivo**).

## Validación

Mensajes personalizables para:

- **Archivo obligatorio** — cuando el paso es obligatorio y no se adjunta nada.
- **Archivo demasiado grande** — usa `{maxSize}` como marcador en el texto.
- **Tipo de archivo no permitido** — usa `{types}` como marcador.

## En el resumen

Puedes definir el **texto de la etiqueta del pie** que representa el archivo subido en el carrusel de selecciones y en el resumen.

Si el paso de subida va dentro de un paso de **Graduación** y detrás pones un [Resumen de graduación](https://docs.getoptical.app/guias/graduacion/#paso-resumen-de-graduación), ahí el cliente ve **la imagen que subió**, no solo su nombre. Con un PDF aparece un icono de documento con nombre y peso. No hay que activar nada.

---

# Complementos, colores, accesorios y acciones externas

> Las formas de vender extras, ofrecer colores dentro de una opción y llevar opciones fuera del carrito.

Source: https://docs.getoptical.app/guias/accesorios-y-addons/
Language: es

Optical Form tiene cuatro mecanismos para cobrar extras y dirigir al cliente más allá de una simple selección. Es importante no confundirlos.

## Complementos (por opción)

Un **complemento** es un producto de Shopify vinculado a **una opción concreta**. Cuando el cliente elige esa opción, el complemento se añade al carrito como **línea separada** y suma su precio al total en vivo.

- Se configuran en la sección **Complementos** de cada opción.
- Cada complemento tiene una **cantidad** — pon **2** para artículos que se facturan por pares (ej. lentes).
- **Su precio es el suplemento**, no el total: la montura ya tiene el suyo. Ver [Precios y cobro](https://docs.getoptical.app/guias/precios-y-cobro/).
- Ejemplos típicos: el tipo de lente, un tratamiento (antirreflejante, filtro azul), un servicio de montaje.

**Crea productos para los complementos**

Los complementos son productos reales de Shopify. Créalos para tipos de lente, tratamientos y servicios con el estado **No listado** (se pueden comprar, pero no aparecen en colecciones ni en el buscador; un producto sin publicar o en borrador **no se puede añadir al carrito**), y luego vincúlalos. Así Shopify los factura, los incluye en el pedido y los envía a tu laboratorio.

**Los complementos pertenecen a esta tienda**

Un complemento guarda el identificador que Shopify le da a ese producto **en tu tienda**, y ese número no existe en ninguna otra. Por eso los complementos **no se copian** al exportar un formulario a otra tienda, y por eso la plantilla de ejemplo viene sin ellos: los vinculas tú con tus productos. Lo explicamos en [Copiar un formulario a otra tienda](https://docs.getoptical.app/guias/copiar-formulario/).

**Los complementos se cobran todos; los colores, solo el elegido**

Si vinculas como complementos **varias variantes del mismo producto** —gris, ámbar y verde de un mismo tinte—, el cliente que elija esa opción se lleva **las tres** al carrito y paga las tres. Casi siempre lo que querías era que **eligiera una**: para eso están los [colores seleccionables](#colores-seleccionables-por-opción). El editor lo detecta y te lo propone con un aviso y un botón, **Convertirlos en colores seleccionables**; se abre el selector con esas variantes ya marcadas y, al confirmar, pasan de complementos a colores. Si cancelas, no cambia nada.

## Colores seleccionables (por opción)

Una opción puede llevar una **fila de muestras de color** debajo: perfecta para lentes polarizadas, tintadas o fotocromáticas que se fabrican en varios colores. El cliente toca un color y **solo ese color se cobra** — a diferencia de los complementos, que se suman todos, los colores son alternativas. Tocar la tarjeta sin elegir color solo la **abre** (borde discontinuo y la frase «Elige un color para continuar»): la opción cuenta como elegida cuando el cliente toca un color.

- Se configuran en la sección **Colores seleccionables** de cada opción, con el mismo selector de productos que los complementos: **cada color es una variante de Shopify**, con su SKU y su precio. Así Shopify lo factura, lo incluye en el pedido y tu laboratorio recibe la referencia exacta del color elegido.
- Cada color tiene un **nombre** (lo que lee el cliente, traducible como cualquier otro texto) y una **muestra**, que es la **imagen de la propia variante**: ponle a cada variante de color su foto de muestra en Shopify y no hay nada más que configurar. Solo si una variante no tiene imagen se usa el campo de color CSS — `#8b5a2b`, o un degradado como `linear-gradient(#555, #ddd)`.
- Si los colores tienen precios distintos, la tarjeta muestra el más barato hasta que el cliente elige — nunca anuncia menos de lo que se puede acabar pagando.
- Al pasar por una muestra de color aparece su **nombre** (y el recargo, si lo dejas activado en Diseño › Opciones); si los colores cuestan distinto, la tarjeta dice «Desde» hasta que el cliente elige.
- El cliente **no puede continuar sin elegir color**: una opción con colores y sin color es una elección a medias, y el pedido saldría sin la referencia que tu laboratorio necesita.
- Cada opción —y cada grupo de colores— admite un **texto de ayuda**: aparece un «?» junto al título que el cliente abre para leer una explicación más larga. Ver [Crear un formulario](https://docs.getoptical.app/guias/crear-formulario/#anatomía-de-una-opción).

**¿Complemento o color?**

Usa un **complemento** para algo que la opción siempre incluye (un tratamiento, un servicio). Usa **colores** cuando la opción se fabrica en varias versiones y el cliente debe elegir exactamente una.

**Lo agotado se ve antes de elegirlo**

Al abrir el configurador, la app consulta el stock de todos los complementos, colores y accesorios del formulario. Lo que no se puede vender —una variante con seguimiento de inventario a 0 que no admite pedidos sin stock, un producto en borrador o archivado, un producto que **no está en el canal Tienda online**, o uno que se ha eliminado de Shopify— se muestra **desactivado con «Agotado»**: la tarjeta de la opción, la del accesorio, y en los colores la muestra de color **tachada**, como en el selector de variantes de tu tema. El cliente no puede elegirlo y, si ya lo tenía elegido —de una visita anterior, o porque lo eligió antes de que llegara la respuesta del stock—, se le quita y el panel se lo dice: **«X ya no está disponible. Vuelve atrás y elige otra opción.»** Si ese paso exige una respuesta, no puede seguir ni añadir al carrito hasta que elija otra. En **Diseño › Opciones** puedes preferir **ocultarlo** en vez de desactivarlo; si ocultar dejara un paso sin nada que elegir, se muestran desactivados igualmente. Un producto **No listado** sigue vendiéndose: solo desaparece de colecciones y buscador.

El editor te avisa de lo mismo desde tu lado, sin que pulses nada: al abrir la pestaña **Pasos** comprueba los productos del formulario y pone una etiqueta junto al complemento, color o accesorio afectado — «Agotado», «Borrador», «No está en Tienda online» o «Eliminado». Si alguno está en borrador, archivado o fuera del canal Tienda online, además sale un aviso rojo encima de los pasos, **«Productos de este formulario que no se pueden añadir al carrito»**, con cada producto y su motivo: mientras siga así, Shopify rechazaría el pedido entero de quien lo eligiera. Cómo arreglarlo: [poner un producto en el canal Tienda online](https://docs.getoptical.app/empezar/antes-de-empezar/#cómo-poner-un-producto-en-el-canal-tienda-online). **Comprobar precios** enseña la misma lista.

**¿Grupos de colores? Un producto por grupo**

¿Quieres colores agrupados — Classic, Fashion, Gradient — como en las grandes tiendas de gafas? Crea **un producto de Shopify por grupo** («Tinte Classic», «Tinte Fashion», «Tinte Gradient»), cada uno con sus variantes de color, y vincula las variantes de los tres **bajo la misma opción**. La app detecta que vienen de productos distintos y convierte la opción en un **desplegable**: al elegirla se abren los grupos, uno por producto, cada uno con su **título** (el nombre del producto, editable y traducible), una **descripción** opcional y sus colores. Si los grupos cuestan distinto, cada uno enseña su precio y la cabecera de la opción no enseña ninguno; si cuestan igual, el precio va en la cabecera. El cliente toca el color que quiere: un solo gesto elige el grupo y el color, y al pedido va solo esa variante.

## Accesorios / cross-sell (paso propio)

Un paso de tipo **Accesorios (cross-sell)** ofrece productos extra **opcionales** en su propio paso: estuches, limpiadores, cordones, etc.

- **Seleccionar productos** — elige los que se ofrecen como cross-sell.
- **Mostrar opción de saltar** — muestra una tarjeta "Continuar sin accesorios". Si está activa, el paso es opcional aunque esté marcado como *Obligatorio*.
- Etiquetas editables: etiqueta y descripción de saltar, error de selección y etiqueta de resumen.

**Diferencia clave:** un complemento depende de elegir una opción; un accesorio es un paso independiente de venta cruzada.

Un accesorio agotado se muestra desactivado con «Agotado» (u oculto, según Diseño › Opciones), igual que los complementos y los colores: ver la nota de arriba.

## Acción externa (por opción)

En lugar de añadir una opción al carrito, puedes convertirla en una **acción externa**: muestra un mensaje y un botón personalizados.

- **Mensaje** — ej. "Solo en tienda".
- **Texto del botón** — ej. "Reservar una cita".
- **URL del botón** — admite `https://`, y también `tel:`, `mailto:`, `sms:` y `https://wa.me/`.

Útil para productos solo disponibles en tienda física, reservas de cita o enlaces de contacto directo (WhatsApp, teléfono, email).

---

# Precios y cobro

> De dónde sale cada euro del total, por qué el precio del complemento es el suplemento y no el total, y los errores que hacen cobrar de más o de menos.

Source: https://docs.getoptical.app/guias/precios-y-cobro/
Language: es

Esta página explica **de dónde sale cada euro** que ve el cliente. Si algún total no te cuadra, la respuesta está aquí.

## La fórmula

```
Total = precio de la montura
      + precio de cada addon elegido × su cantidad
      + accesorios que añada el cliente
```

Nada más. No hay márgenes ocultos ni cálculos propios de la app: **cada línea es un producto de Shopify con su precio**, y el total es la suma.

Por eso el total del formulario y el del carrito siempre coinciden — es el mismo cálculo.

## 🔴 El complemento es el suplemento, no el total

El error más caro, y el más fácil de cometer.

La montura **ya tiene su precio**. Cuando creas el producto "Lente fina 1.60", su precio debe ser **lo que cobras de más** por esa lente, no lo que vale el conjunto.

| Montura | Lente fina | El cliente paga |
|---|---|---|
| 100 € | **15 €** ✅ | 115 € |
| 100 € | ~~115 €~~ ❌ | 215 € |

Suena obvio escrito, pero es fácil pensar en "gafa completa" al crear el producto. La regla sencilla: **si la montura sola vale 100 €, tus complementos son lo que sumas a esos 100 €**.

## Lo que va incluido: créalo a 0 €

Puede parecer inútil crear un producto que vale 0 €, pero tiene dos motivos:

1. **El cliente ve "Incluido"** en vez de un hueco vacío. Comunica valor: la lente estándar entra en el precio.
2. **La línea llega al pedido**, y tu laboratorio sabe qué lente montar. Sin producto, esa información no viaja a ninguna parte.

Ejemplo típico: *Lente monofocal estándar 1.50 — 0,00 €*.

**Cambiar la etiqueta**

Si prefieres que ponga otra cosa en vez de "Incluido", se cambia en **Apariencia → Etiqueta de incluido**. Déjala vacía y se usa el texto traducido de la app.

## Cantidad: el caso de las lentes

Cada complemento tiene una **cantidad**. Por defecto 1.

Las lentes se venden **por pares**, así que si el precio de tu producto es *por lente*, pon **cantidad 2**. Si el precio ya es el del par, déjala en 1.

Las dos formas valen. Lo que no vale es mezclarlas sin darte cuenta: decide una y aplícala a todas tus lentes.

## 🔴 El distintivo no cobra

En cada opción puedes poner un **distintivo informativo**: un texto pequeño junto al nombre.

> **Es solo texto. No suma nada al total.**

Si escribes `+30 €` en el distintivo pero no vinculas un complemento, el cliente **verá 30 € y pagará 0 €**. Es un error silencioso: nada falla, simplemente cobras de menos, y lo descubres cuadrando caja.

**Úsalo para cosas que no son precio** —"Solo en tienda", "Más vendido", "Nuevo"— y deja que los precios los muestre el complemento, que es el que cobra de verdad.

## Qué ve el cliente mientras elige

- **El total se actualiza en vivo** con cada selección.
- Las opciones con complemento muestran su suplemento; las de 0 € muestran "Incluido".
- El suplemento se lee **«+70,00 €»** por defecto. Puedes cambiar cómo se escribe en **Diseño → Textos de la interfaz → Precios y resumen → Suplemento de una opción**, por idioma: `{price} extra` da «70,00 € extra» y `Añade {price}` da «Añade 70,00 €». Se aplica en la tarjeta y en los colores con recargo. Sin el «+», el cliente puede leer el importe como el precio total: si lo que quieres es enseñar el total, usa el modo **Precio total** en la opción o en el paso; y si quieres el precio de la opción sin signo, **Solo el precio de la opción** ([los cuatro modos](#el-precio-de-cada-tarjeta-cuatro-modos)).
- Puedes ocultar los precios por opción en **Apariencia → Mostrar ajustes de precio**, si prefieres enseñar solo el total.
- En el modo **Precio de partida** (la tarjeta enseña lo que costaría el conjunto, no el suplemento), la palabra **«Desde»** solo aparece en las opciones desde las que el precio **aún puede subir**: porque les sigue un tratamiento con precio, un color con recargo, unas lentillas o un paso de accesorios. Una opción que termina el formulario, o a la que solo le siguen pasos gratuitos, enseña su total sin «Desde». No hay nada que configurar: la palabra sigue a cada opción.

### El precio de cada tarjeta: cuatro modos

Qué importe enseña la tarjeta de una opción lo eliges tú en el editor del formulario: en cada paso, el desplegable **Precio que se muestra en las opciones**; y si una opción necesita otra cosa que el resto de su paso, en esa opción, **Precio que se muestra en esta opción**. Con una montura de 85 € y una opción cuyo complemento cuesta 25 €:

| Modo | La tarjeta dice | Qué cuenta |
|---|---|---|
| **Solo el coste añadido** | «+25,00 €» | Lo que esa opción suma. Es el por defecto. |
| **Precio de partida** | «Desde 110,00 €» | La montura, lo elegido hasta ahí, la opción y lo más barato que quede por elegir. Para un primer paso que reparte caminos. |
| **Precio total** | «110,00 €» | La montura, lo elegido hasta ahí y la opción. Para un paso tras el que ya no se cobra nada. |
| **Solo el precio de la opción** | «25,00 €» | Solo lo que cuesta esa opción: sin el «+», sin la montura y sin lo elegido en pasos anteriores. |

**Solo el precio de la opción** es para los pasos en los que cada opción se lee como un producto con su precio —un paquete de lentes de 59 €— y no como un extra. Se nota sobre todo cuando un paso anterior ya ha cobrado algo: con un recargo de 35 € por montaje al espacio elegido antes, **Precio total** enseña ese paquete como «94,00 €» (suma lo ya elegido, para coincidir con el total del pie) y **Solo el coste añadido** como «+59,00 €». Con **Solo el precio de la opción** dice «59,00 €», y el recargo se queda en su paso y en el total.

Tres detalles de ese modo:

- Una opción de 0 € sigue mostrando "Incluido", igual que en **Solo el coste añadido**.
- Si la opción lleva colores con recargos distintos, dice «Desde» hasta que el cliente elige uno.
- El texto del suplemento que hayas escrito en Diseño no se aplica: la tarjeta enseña el importe solo.

El modo solo decide **lo que se lee en la tarjeta**. El total del pie, el carrito y lo que se cobra son los mismos en los cuatro.

## En el carrito

La montura y cada extra son **líneas separadas**, agrupadas visualmente bajo la montura:

```
Montura Archer ......................... 100,00 €
  └ Lente monofocal fina 1.60 ........... 15,00 €
  └ Antirreflejante premium ............. 30,00 €
                                 Total   145,00 €
```

Las líneas de complemento **no tienen selector de cantidad ni botón de borrar**: son parte del conjunto. Al eliminar la montura desaparecen todas.

Que sean líneas separadas no es un detalle estético: es lo que permite que Shopify facture cada concepto, lo desglose en el pedido y lo envíe a tu laboratorio.

## Descuentos e impuestos

- Los **descuentos automáticos** y los códigos funcionan con normalidad, pero muchos se aplican **en el checkout**, no en el carrito. Que el total del carrito no muestre el descuento no significa que no vaya a aplicarse.
- Los **impuestos** siguen la configuración de tu tienda, como en cualquier otro producto.
- Si vendes en **varios países o monedas** (Shopify Markets), el formulario enseña los precios **del mercado del visitante**: la montura y también cada suplemento, con el ajuste de precio o la moneda que tengas en ese mercado. Así el total coincide con el carrito y el checkout de ese país. No hay nada que configurar: se activa solo cuando la tienda vende en más de un país. Compruébalo desde el mismo país que tu cliente, o con el selector de país de tu tema.

## Comprobación antes de abrir

Haz un pedido de prueba tú mismo y comprueba las tres cosas:

- [ ] El total del formulario **coincide** con el del carrito
- [ ] El total del carrito **coincide** con el del checkout
- [ ] El pedido en tu panel trae **cada extra como su propia línea**, con su precio

Si los tres cuadran, el cobro está bien montado.

## Cómo hago…

**…que un tratamiento sea gratis solo en algunas monturas**
Crea dos formularios, uno con el complemento a 0 € y otro con el precio normal, y asigna cada uno a su grupo de productos.

**…subir el precio de un tratamiento**
Cambia el precio del producto en Shopify. No hace falta tocar el formulario ni volver a sincronizar: el complemento apunta al producto, y el precio lo pone el producto.

**…que un paquete de lentes enseñe su precio, sin «+» y sin sumarle nada**
En el paso de los paquetes, pon **Precio que se muestra en las opciones** en **Solo el precio de la opción** y guarda. Cada tarjeta dirá lo que cuesta ese paquete; el total del pie sigue sumando la montura y lo elegido antes.

**…ver cuánto me deja cada extra**
Como son productos reales de Shopify, salen en tus informes de ventas por producto igual que cualquier otro artículo.

---

# Diseño y carrito

> Personaliza colores, tipografía, comportamiento y qué datos del formulario se muestran en el carrito.

Source: https://docs.getoptical.app/guias/diseno-y-carrito/
Language: es

La pestaña **Diseño** de cada formulario controla su apariencia, su comportamiento y qué información llega al carrito. Cada sección gobierna una zona concreta del panel.

## Comportamiento

Activa o desactiva secciones del panel:

- **Mostrar ajustes de precio** — muestra la diferencia de precio junto a cada opción (ej. `+$10.00`).
- **Mostrar barra de progreso** — indica cuánto le queda al cliente.
- **Mostrar paso de resumen** — añade un último paso de revisión antes de añadir al carrito.
- **Mostrar el total en el botón Siguiente** — muestra el total acumulado en cada paso, no solo al final.

## Panel

Posición y forma del panel: **anchura** (px), **posición** (derecha / izquierda / pantalla completa), **opacidad del fondo** (%) y **radio del borde** (px).

### Pantalla completa (escritorio)

Con la posición en **Pantalla completa**, en escritorio el configurador ocupa toda la pantalla dividida **a partes iguales**: a la izquierda, la **imagen del producto** — con el nombre y la variante — y el **resumen en vivo** de lo que el cliente lleva configurado, con su total; a la derecha, los pasos. Si el cliente cambia de variante dentro del formulario (un color de montura, un pack), la foto y el nombre de la izquierda cambian con él.

**Ancho máximo** (visible al elegir esta posición): en 0 el área usa toda la pantalla; por encima de 0 el contenido se centra y lo que sobra se convierte en márgenes laterales — para que en un monitor muy ancho el configurador no se desparrame.

**Fondo de la columna de la imagen** (también solo en esta posición): el color de toda la mitad izquierda — foto, resumen y su margen lateral. Vacío sigue al fondo de las tarjetas.

**Animación de entrada**: la pantalla completa no entra deslizándose como el panel lateral; aparece con un fundido y un gesto corto que eliges aquí — zoom, subida, dos mitades (la foto desde la izquierda y los pasos desde la derecha) o solo el fundido. Quien tiene activado «reducir movimiento» en su dispositivo ve siempre el fundido a secas — y lo mismo en el panel lateral: aparece con un fundido en vez de deslizarse, y los pasos cambian sin desplazarse. No hay que configurar nada: la app obedece la preferencia del dispositivo del cliente.

En **móvil se mantiene el panel lateral** de siempre: una pantalla partida necesita anchura para existir. No cambia nada más — mismos pasos, mismos precios, mismo carrito.

**Accesibilidad**: el panel es un diálogo modal de verdad. Mientras está abierto, el resto de la página queda inerte para el teclado y los lectores de pantalla; el foco entra al abrir, no se escapa con Tab y vuelve al botón al cerrar. La barra de progreso anuncia en qué paso va («paso 2 de 5»), todo lo enfocable lleva un anillo de foco de dos capas que se ve sobre cualquier color de fondo, y el botón «Atrás» del navegador retrocede un paso (en el primero, cierra el panel sin salir de la página de producto). No hay nada que configurar.

## Ayuda emergente

Cada opción (y cada grupo de colores) admite un **texto de ayuda**: si lo rellenas, aparece un «?» junto al título que el cliente abre para leer una explicación más larga, con lo que la descripción puede quedarse en una línea. Se muestra al pasar el ratón o al pulsarlo, y se cierra tocando fuera.

Esta sección viste esa burbuja, los «?» de [los campos de la receta](https://docs.getoptical.app/guias/graduacion/#el-cliente-tiene-ayuda-en-cada-campo) **y** la ayuda emergente con el nombre de cada color: **fondo** y **texto** (vacíos, siguen a los colores del formulario: blanco y negro por defecto, con un borde fino), **radio** (0 por defecto), **relleno** horizontal y vertical, **tamaño de letra**, **ancho máximo** de la burbuja de ayuda (0 = tan ancha como la columna de texto) y **color y tamaño del icono «?»**.

Si no quieres que la ayuda emergente del color diga también el recargo («Gris (+€80,00)»), desactívalo en **Diseño › Opciones › Mostrar el recargo en la ayuda emergente del color**: queda solo el nombre, y el precio sigue bajo la fila al elegir un color.

## Plantilla de diseño

Un aspecto completo en un clic, antes de tocar nada más:

- **Clásica** — el panel de siempre, pegado al borde y compacto.
- **Moderna** — más espacio, esquinas suaves, bordes finos y una escala de tipografía pensada; el panel flota como una tarjeta separada del borde. Es la que traen los formularios de ejemplo.
- **Oscura** — la misma disposición que Moderna sobre fondo carbón, tarjetas grafito, tinta clara y acento bermellón. Pensada para gafas de sol y monturas premium: un configurador que parece parte del producto. Es la única plantilla que **trae sus propios colores**.

Clásica y Moderna cambian espaciado, esquinas y tamaños de texto, **nunca tus colores**. Oscura sí los escribe al elegirla, y al volver a otra plantilla los devuelve a los valores por defecto — el panel te avisa si has cambiado algo desde que la aplicaste, con un botón para volver a aplicarla.

Para un panel oscuro conviene usar los iconos del juego `on-dark/` del [pack de iconos](https://docs.getoptical.app/guias/iconos/): sobre fondo oscuro, los de fondo claro desaparecen.

## Colores

**Acento**, **texto sobre acento**, **fondo**, **texto**, **texto atenuado** y **bordes** — para encajar con tu marca. Por defecto usan un acento neutro.

## Tipografía

Tamaños y grosores para **encabezado**, **título del paso**, **descripción del paso**, **texto de las opciones** (título, descripción, precio y grosor del precio) y las **ventajas**. Bajo el título del paso, **Separación entre título y descripción** (8 px por defecto) mueve solo ese hueco; la distancia de la cabecera a las opciones no cambia.

Las ventajas vienen en **automático**: se colocan un punto por debajo de la descripción de la opción y la siguen si la cambias, que es lo que mantiene la jerarquía de la tarjeta. Dales un tamaño propio solo si lo necesitas; el deslizador a cero vuelve a automático.

## Opciones

Estilo de cada tarjeta: **padding** horizontal/vertical, **separación** entre opciones, **grosor del borde**, **tamaño de imagen** y la **etiqueta para opciones gratuitas** ("Incluido"). En un paso donde ninguna opción tiene precio —cómo nos envías la graduación, por ejemplo— las tarjetas no muestran esa etiqueta: «Incluido» solo aparece junto a un recargo. Y el espacio dentro de la tarjeta: **espacio a la derecha del texto** antes del precio (24 px en escritorio y 0 en móvil por defecto), **separación entre el título y la descripción** de la opción (2 px por defecto) y **espacio sobre las ventajas** (12 px por defecto). También el **hueco entre la imagen y el texto** y el **redondeo de la imagen** de la opción; el **encaje de la imagen**: **Entera** (por defecto) la enseña completa dentro de su cuadrado, y si no es cuadrada quedan márgenes; **Recortar para llenar** ocupa todo el cuadrado y corta los bordes, útil con fotos; las **ventajas** (relleno, forma píldora / redondeada / recta y separación entre ventajas); la **separación entre las muestras de color**; y la **tarjeta de accesorio** (su relleno y el hueco de la imagen al texto). Todos vienen por defecto con los valores que el panel usaba hasta ahora: no cambia nada hasta que los toques. La excepción es el encaje: antes la imagen se recortaba siempre, y ahora por defecto se ve entera. Con una imagen cuadrada, que es lo habitual, se ve igual.

Para las opciones con [colores seleccionables](https://docs.getoptical.app/guias/accesorios-y-addons/#colores-seleccionables-por-opción): el **tamaño de las muestras de color** (por debajo de 32 px cuesta acertarles en el móvil), si la ayuda emergente que aparece al pasar por una muestra de color muestra también el **recargo** («Gris (+€80,00)») o solo el nombre, y el texto **«Elige un color para continuar»** — puedes reescribirlo, y decidir si se muestra bajo la fila de colores o solo como aviso sobre el botón Siguiente.

**Complementos, colores y accesorios agotados**: qué hace el panel con lo que no se puede vender ahora mismo — mostrarlo **desactivado con «Agotado»** (por defecto; en los colores, la muestra de color tachada) u **ocultarlo**. Si ocultar dejara un paso sin opciones, se muestran desactivadas. Ver [lo agotado se ve antes de elegirlo](https://docs.getoptical.app/guias/accesorios-y-addons/#colores-seleccionables-por-opción).

## Navegación

Barra de progreso y botones: **altura de la barra**, **tamaño/grosor/padding del botón**, el **carrusel de selecciones del pie** (mostrar en escritorio/móvil, prefijar con el nombre del paso) y el **contador de pasos** (palabra separadora, ej. "2 de 4").

**Espacio libre a la derecha del pie** — si tu tienda tiene un botón de chat en la esquina inferior derecha (WhatsApp, Tidio, Gorgias…), queda justo encima del botón *Siguiente* del panel. Este ajuste deja ese hueco vacío para que el chat flote sobre nada: unos 72 px bastan para el botón de chat habitual. Por defecto es 0 y el pie no cambia.

**Mostrar la atribución de GetOptical en la cabecera** — desactivado por defecto en el plan de pago. Si lo activas, en la esquina superior izquierda del configurador aparece un icono de 24 píxeles (solo el icono, sin texto) que enlaza a la página de la app en el App Store. Es el patrón de atribución que Shopify permite a las apps en la tienda. En el plan gratuito de cortesía el icono forma parte del plan y se muestra siempre; el ajuste no aparece.

**Recordar la configuración a medias** — desactivado por defecto; actívalo tú si lo quieres. Si el cliente cierra el configurador sin terminar y vuelve al mismo producto en los 7 días siguientes, en vez del primer paso ve «Tenías una configuración a medias» con dos botones: *Continuar donde lo dejaste* y *Empezar de nuevo*. Al continuar recupera lo que había elegido (con los precios de hoy, y solo las opciones que sigan existiendo) y vuelve al primer paso que le falte. Lo que **no** se recuerda: la graduación, la receta de lectura, las lentillas y los archivos, que vuelve a introducir. El borrador vive en el navegador del cliente, nunca en nuestros servidores, y se borra al añadir al carrito, al empezar de nuevo o a los 7 días. Desactívalo si varios clientes comparten un mismo dispositivo (un quiosco en tienda). Debajo, **«Ofrecer continuar a partir de N pasos completados»** (2 por defecto): con menos pasos hechos no se guarda nada, porque rehacer uno cuesta lo mismo que responder al aviso; súbelo si solo quieres rescatar a quien casi terminó. Los textos del aviso se cambian en Diseño › Textos, y en Analítica ves cuántos retoman.

## Resumen y Total

La lista de selecciones y la línea de total: tamaños de **título**, **items** y **total**; **fondo** y **color del total**; una línea de **envío** (etiqueta + valor, ej. "Gratis (Peninsular)"); y la opción de **prefijar las líneas del resumen** con el nombre del paso.

## Qué ve el cliente de lo que eligió

Debajo del producto, en el carrito, aparece lo que el cliente configuró: los pasos que eligió y su receta. Algo así:

```
Tipo de gafas: Gafas graduadas
Tipo de lente: Lentes finas estándar
OD: ESF -2.50 · CIL -1.25 · EJE 90° · ADD +1.50
OI: ESF -3.00 · CIL 0.00 · EJE — · ADD +2.00
DIP: 63
Accesorios: Funda rígida
```

Tienes dos interruptores para ocultarle esto **al cliente**:

- **Ocultar los valores de graduación al cliente**
- **Ocultar las etiquetas de selección al cliente**

**Ojo: «ocultar» significa ocultar en todas partes**

Aquí se equivoca casi todo el mundo, porque suena a que solo afecta al carrito.

Cuando activas uno de estos interruptores, esos datos desaparecen de **todo lo que ve el cliente**: el carrito, el checkout, la página de estado del pedido **y el email de confirmación**.

**Tú los sigues viendo** en el detalle del pedido, dentro de tu admin de Shopify, y viajan igual a tu laboratorio. Pero tu cliente ya no puede comprobar en ningún momento qué graduación pidió.

Es todo o nada: Shopify no permite mostrar un dato en el email y esconderlo en el carrito.

**Nuestra recomendación:** deja desactivado el de la graduación. Que el cliente reciba su receta por email es su única forma de detectar un error después de comprar, y a ti te ahorra la devolución.

### Quitar un paso concreto del pedido

A veces hay un paso que no aporta nada al pedido: por ejemplo, uno que solo pregunta *cómo* quiere el cliente darte su graduación. Los propios valores de la receta ya lo dicen, así que esa línea solo alarga el carrito.

Dentro de cada paso, en el editor, tienes la casilla **Ocultar del carrito y del pedido**.

Y al lado, en los pasos de elección única, **Si este paso solo tiene una opción, elegirla y saltar el paso**: el cliente no ve esa pantalla, la opción va igualmente al pedido con su etiqueta, y el botón Atrás vuelve a la última pantalla que sí vio. Viene desactivada: si la única opción está ahí a propósito —un precio que enseñar, una condición que leer—, déjala desactivada. Un paso cuya única opción tenga colores seleccionables o un enlace externo se enseña siempre.

Esa casilla **no aparece** en los pasos que llevan la receta ni en el de subir foto: un pedido de gafas graduadas sin graduación no se puede fabricar, así que la app no te deja llegar ahí.

**Cuidado con los pasos que se llaman igual**

Es habitual tener varios pasos titulados «Graduación» —el que pregunta el método, el que captura los valores, el de subir la foto—. Fíjate en la **etiqueta de color** que hay junto al título de cada paso: te dice de qué tipo es. También puedes rellenar el **ID interno** de cada paso («método», «valores», «foto») para distinguirlos de un vistazo.

## El bundle en el carrito

El producto principal + lentes/complementos + accesorios se **agrupan como un bundle** bajo una sola línea, igual que se lee en el checkout. La relación se mantiene de forma nativa (`parent_id`) para el **borrado en cascada**, el **checkout** y los **emails de pedido** — si el cliente elimina el producto principal, se quitan también sus complementos. Ver [Integración con el tema](https://docs.getoptical.app/desarrolladores/integracion/) para el detalle técnico.

### Cómo se ve, lo decide tu tema

La app **no aplica ni un estilo al carrito**. Lo que ves ahí —el sangrado de las líneas de complemento, los tamaños, los separadores— lo muestra tu tema, y así se mantiene coherente con el resto de tu tienda aunque cambies de plantilla.

Los temas modernos como Horizon anidan las líneas del bundle por su cuenta. Si el tuyo no lo hace, o si quieres afinar cómo se ve, tienes tres ajustes en la incrustación de la app:

- **Compactar las líneas de complementos** — deja las líneas de los complementos más pequeñas que la del producto principal, para que las gafas sigan siendo la protagonista y los extras se lean como parte de ellas. **Nace desactivada**, y activada solo cambia tamaños.
- **Qué controles enseña cada línea del conjunto** — tres ajustes: **Complementos en el carrito** (con sus controles, sin controles u ocultos del carrito; por defecto, sin controles), **Ocultar el botón de eliminar de los accesorios** (por defecto, desactivado) y **Ocultar el selector de cantidad de las lentillas** (por defecto, activado). La incrustación nace con los controles que no sirven para nada bueno escondidos: la papelera de una lente solo rompe el conjunto, y el selector de una lentilla solo deshace lo que el configurador fijó. Si ya tenías la incrustación activada, conservas lo que elegiste. Ver [Botón y carrito](https://docs.getoptical.app/desarrolladores/boton-y-carrito/).
- **CSS personalizado** — para cualquier ajuste que quieras hacer tú. En [Temas probados](https://docs.getoptical.app/guias/temas-probados/#cualquier-tema-las-clases-que-deja-la-integración-con-el-carrito) están las clases que la integración con el carrito deja en cada fila.

**Por qué ahora es decisión tuya**

Esconder un control nunca impidió la acción: quien quiera puede cambiar la línea igual. Lo que cambia desde la 1.5 es que **la app cuadra el conjunto ella misma**: un complemento cambiado por su cuenta vuelve a su sitio, si el cliente sube la montura los complementos suben con ella (o vuelve a 1, si eliges «Bloquear»), y si quita una lente, el conjunto entero se va (ver más abajo). Con el pedido a salvo, esconder controles es solo una cuestión de limpieza, y por eso te la dejamos a ti. Las reglas solo alcanzan a las filas de un conjunto de Optical Form: la papelera de otras apps —garantías, seguros de envío— no se toca.

### Si el cliente quita una lente

Una montura «configurada» sin sus lentes es un pedido que el laboratorio no puede hacer. Si el cliente quita desde el carrito de tu tema una lente, un tratamiento o un color, la app **quita el conjunto entero** —la montura y el resto de sus complementos— y muestra un aviso corto en el carrito; puede volver a configurarla cuando quiera. Los accesorios no cuentan: quitar un líquido o una funda no toca nada más. Si en tu tienda una montura se puede comprar sola, **Si se quita una lente o un tratamiento**, en la incrustación de la app, tiene la opción «Conservar la montura y avisar»: la montura se queda marcada, con un aviso bajo la línea, y la decisión es tuya (el evento [`optical-form:cart:orphan`](https://docs.getoptical.app/desarrolladores/eventos/#optical-formcartorphan--en-el-carrito-falta-una-línea-del-conjunto) te lo cuenta).

### La cantidad, desde el carrito

Si el cliente sube la cantidad de la montura en el carrito de tu tema, las lentes y los tratamientos se multiplican con ella; los accesorios van libres; y las lentillas vuelven a sus cajas, porque esas se eligen en el configurador. **Cantidad del conjunto desde el carrito**, en la incrustación de la app, elige entre «Escalar» (por defecto) y «Bloquear» (siempre 1 por conjunto, con un aviso). Detalle en [Temas probados](https://docs.getoptical.app/guias/temas-probados/#cambiar-la-cantidad-desde-el-carrito).

---

# Ajustes en el editor de temas

> Los dos sitios donde Optical Form pone ajustes en tu tema, qué hace cada uno, y el CSS personalizado.

Source: https://docs.getoptical.app/guias/ajustes-del-tema/
Language: es

Optical Form pone ajustes en **dos sitios distintos** del editor de temas, y confundirlos es la causa número uno de «lo he activado y no se ve nada».

| | Dónde está | Qué controla |
|---|---|---|
| **La incrustación de la app** | Personalizar → **Incrustaciones de aplicaciones** | Lo general: el carrito, el CSS personalizado. Una vez para toda la tienda |
| **El bloque** | Personalizar → plantilla **Producto** → Añadir bloque | **El botón**: cómo se ve y dónde va |

La regla corta: **la incrustación hace que funcione, el bloque hace que se vea.** Con solo la incrustación, la página de producto no muestra nada.

---

## La incrustación (Apps)

Personalizar → **Incrustaciones de aplicaciones** → **Optical Form Drawer**.

### Aspecto del carrito

**Compactar las líneas de complementos.** Tu tema imprime cada complemento como una línea más, del mismo tamaño que el producto principal. Esta casilla las hace más pequeñas, para que las gafas sigan siendo la protagonista y los extras se lean como parte de ellas.

**Nace desactivada**, y activada **solo cambia tamaños**: no esconde la cantidad ni el botón de eliminar. Está probada en Horizon 4.x; en otros temas no hace nada, porque el marcado al que se agarra no existe ahí.

**Por qué no esconde el botón de eliminar**

Es tentador esconderlo para que nadie descuadre el pedido. No sirve: esconder un control no impide la acción. Y esa fila la comparten otras apps —garantías, seguros de envío—, así que esconderles su papelera dejaría a tu cliente sin poder quitar un cargo que no es tuyo.

### CSS personalizado

Un campo de texto para tus propias reglas. Se cargan **después** de las de la app y del tema, así que ganan sin que tengas que pelearte con la especificidad.

Para qué se usa normalmente:

```css
/* Achicar la fila de un complemento en el carrito (Horizon 4.x) */
.cart-items__nested-line .cart-items__title { font-size: 13px; }
.cart-items__nested-line .cart-items__details { font-size: 12px; }
```

**Es CSS de TU tema, no de la app**

Estas reglas apuntan a las clases que usa tu tema, y **esas clases cambian de un tema a otro**. Una regla escrita para Horizon puede no casar con nada en Dawn. Si cambias de tema, revisa este campo.

Y no hace falta para el caso más común: la casilla de arriba ya trae la receta de Horizon hecha.

### Integración con el carrito

**Después de añadir al carrito** — qué pasa al terminar el formulario: abrir el panel del carrito de tu tema, ir a la página del carrito, o no hacer nada.

**«No hacer nada» en Horizon**

Con «no hacer nada» la app no abre nada, pero tu tema sigue reaccionando como a cualquier añadido. Horizon abre su panel del carrito por su cuenta si tiene activado su propio ajuste **«Abrir el carrito al añadir»**: si no quieres que se abra, desactívalo en los ajustes del tema (Carrito), no aquí.

**Mantener el carrito sincronizado** — cuando el cliente borra las gafas, se van también sus lentes y complementos. **Déjalo activado** salvo que sepas por qué lo desactivas: sin esto tu cliente puede quedarse con unas lentes sueltas en el carrito, sin montura.

Y al revés: si el cliente borra las lentes desde el carrito de tu tema y deja la montura sola, la app lo detecta y pone un aviso bajo esa línea para que lo vea antes de pagar — un pedido de gafas graduadas sin lentes no se puede fabricar. No borra nada ni bloquea el pago; si quieres ir más allá, tu tema recibe un evento (ver [Integración](https://docs.getoptical.app/desarrolladores/integracion/)). Mientras la app recoloca las líneas justo después de añadir, el botón de pagar espera un instante.

### Avanzado

Solo hacen falta si tu tema no es estándar y el ajuste automático falla:

| | Para qué |
|---|---|
| **Abrir el panel del carrito desde el icono** | Si tu tema no abre su propio panel del carrito al pulsar el icono |
| **Selector del contador del carrito** (CSS) | El número que va sobre el icono, si no lo encuentra solo |
| **Selector del icono del carrito** (CSS) | El icono, si no lo encuentra solo |
| **IDs de secciones a refrescar** | Las secciones del tema que deben actualizarse al añadir |
| **Modo depuración** | Escribe en la consola del navegador lo que va haciendo. Para pasárnoslo si algo falla |

**Déjalos vacíos primero**

Todos se detectan solos en la mayoría de temas. Rellénalos solo si algo no funciona, y de uno en uno: así sabes cuál era.

---

## El bloque (página de producto)

Personalizar → cambia la vista a **Producto** → **Añadir bloque** → **Optical Form**.

Este bloque dibuja **el botón** que abre el formulario. Colócalo donde quieras, normalmente junto al de añadir al carrito.

### Ocultar el configurador en un producto concreto

Al final de los ajustes del bloque, en *Avanzado*: **Etiqueta de producto que oculta el configurador** — por defecto, `optical-form-off`. Un producto que lleve esa etiqueta **no enseña el botón**, aunque tenga un formulario asignado o pertenezca a una colección asignada. Es la forma de dejar fuera un producto concreto sin tocar colecciones ni formularios: una montura de exposición, un modelo que solo vendes sin lentes, un producto en liquidación. La etiqueta se escribe en el producto, en tu admin de Shopify (*Productos › el producto › Etiquetas*), tal cual, respetando mayúsculas y minúsculas.

Si prefieres otra palabra, cámbiala aquí. Si vacías el campo, el interruptor deja de existir. En el editor de temas, un producto oculto por su etiqueta te lo dice en el hueco del botón; tus clientes no ven nada.

### Contenido del botón

**Texto** (déjalo vacío para usar el traducido por defecto), **icono** (opcional, desde tus archivos), **posición del icono** (izquierda o derecha) y **separación entre icono y texto**.

### Colores

Fondo, texto y borde, cada uno con **su versión al pasar el ratón**. Seis en total, para que encaje con tu marca en los dos estados.

### Forma y tipografía

**Radio de las esquinas**, **grosor del borde**, **grosor de la letra**, **espaciado entre letras** y **mayúsculas** (normal, TODO MAYÚSCULAS, Tipo Título).

### Escritorio y Móvil

Los mismos siete ajustes, **por separado** para cada tamaño de pantalla:

- **Ajustar al texto** — el botón ocupa solo lo que necesita, en vez de todo el ancho
- **Anchura**, **relleno vertical** y **horizontal**
- **Tamaño de letra**
- **Alineación del contenido** — centrado, o texto e icono separados a los extremos
- **Tamaño del icono**

**Empieza por móvil**

Más de la mitad de tus clientes compran ahí, y un botón que en escritorio se ve bien puede quedar apretado en un teléfono. El editor te deja alternar entre las dos vistas sin salir.

### Avanzado — integración con el tema

**Selector del campo de variante (CSS)** — solo si tu tema no usa el campo de variante estándar. Le dice al formulario dónde leer qué variante ha elegido el cliente, para llevarse la correcta al carrito.

Déjalo vacío salvo que el formulario esté añadiendo la variante equivocada.

---

## Cuando algo no encaja

1. **No se ve el botón** → falta el bloque, o el formulario no está *Activo + Sincronizado*. Ver [Instalar](https://docs.getoptical.app/empezar/instalacion/).
2. **El carrito se ve raro** → mira primero la casilla de compactar; el CSS personalizado es el último recurso.
3. **Se añade la variante equivocada** → el selector de variante del bloque.
4. **Nada de lo anterior** → activa el **modo depuración**, reproduce el problema y mándanos lo que salga en la consola.

---

# Temas probados

> Los temas de Shopify en los que hemos comprobado el carrito de Optical Form, el CSS que dejamos listo para cada uno y qué hacer si tu tema no está en la lista.

Source: https://docs.getoptical.app/guias/temas-probados/
Language: es

Optical Form añade la montura y cada complemento como **líneas separadas** del carrito, agrupadas bajo la montura. Cómo se ve ese grupo depende del tema: cada uno muestra sus líneas a su manera, y no todos saben anidarlas.

Aquí están los temas en los que **nuestro equipo ha probado el carrito de principio a fin** —añadir desde el formulario, panel del carrito abierto, líneas visibles, receta legible— y lo que hay que ajustar en cada uno para que quede pulido.

## La tabla

| Tema | Versiones | Estado | Qué hacer |
|---|---|---|---|
| **Horizon** | 2.0.1 · 4.1 – 4.2.0 | ✅ Es nuestra referencia: complementos agrupados bajo la montura, sin controles propios. 4.1 probado en escritorio y móvil; 4.2.0 (septiembre de 2026) en escritorio; 2.0.1 en una tienda real | Activar **Compact the add-on lines in the cart** si quieres las líneas de complemento más pequeñas; qué controles enseña cada fila se decide en la incrustación de la app |
| **Dawn** | 15.2 – 16.0 | ✅ Probado en escritorio y móvil, en el panel y en la página del carrito | Nada obligatorio: los controles se deciden en la incrustación de la app; CSS opcional abajo para anidar y reducir las líneas |
| **Split** (KrownThemes) | 4.4 | ✅ Probado en escritorio en una tienda real: el panel del carrito se abre con la montura y sus complementos, y al borrar la montura se van con ella | Activar **Compact the add-on lines in the cart** y elegir en **Add-ons in the cart** si las filas de complemento llevan controles; CSS opcional abajo para afinar |
| **Glassglow** | 9.0 | 🟠 En curso: el panel del carrito se abre y se actualiza con las funciones del propio tema y nuestras líneas caen en él; nos falta verlo con el formulario activo en la tienda. Su mini-cart no enseña las propiedades de línea (la configuración y la receta salen en la página del carrito y en el checkout) y lista como mucho 5 líneas | Escríbenos antes de activarlo |

## Horizon

No hace falta CSS. En **Tema › Incrustaciones de aplicaciones › Optical Form Drawer**, activa **Compact the add-on lines in the cart**: Horizon ya anida las líneas del conjunto bajo la montura, y esa casilla las hace más pequeñas para que las gafas sean el titular. Horizon muestra un selector de cantidad y una papelera en todas las filas, también en las líneas de complemento: si prefieres que los complementos no los enseñen, es el ajuste **Add-ons in the cart** de la misma incrustación de la app. Ver [Cambiar la cantidad desde el carrito](#cambiar-la-cantidad-desde-el-carrito).

Dos cosas de **Horizon 4.2.0** que conviene saber:

- Si actualizas desde la Theme Store, el tema nuevo llega **sin el bloque «Optical Form»** en la plantilla de producto (la incrustación de la app sí se conserva, porque es un ajuste de la app). Vuelve a colocarlo en **Personalizar › Plantilla de producto › Añadir bloque › Apps**.
- Su ajuste **«"Add to cart" auto-opens drawer»** (Ajustes del tema › Cart) viene desactivado. Con él desactivado, el panel del carrito lo abre Optical Form cuando el tema ya ha mostrado las líneas; con él activado lo abre el tema al instante, y las líneas van en la misma petición que el añadido, así que también se abre lleno.

## Dawn 15.x

Dawn muestra cada complemento como una línea igual que la montura, con su selector de cantidad y su papelera. Qué controles enseña cada fila lo decides en la incrustación de la app (**Add-ons in the cart**, **Hide the remove button of accessories**, **Hide the quantity selector of contact lenses**), y funciona igual en el panel y en la página del carrito. Si además quieres las líneas de complemento agrupadas bajo la montura y más pequeñas, como en Horizon:

1. Ve a **Tienda online › Temas › Personalizar › Incrustaciones de aplicaciones › Optical Form Drawer**.
2. Pega esto en **Custom CSS** y guarda:

```css
/* Optical Form · Dawn 15.x/16.x — complementos anidados y reducidos bajo la montura, como en Horizon */
.cart-item.ofd-bundle-child td { padding-top: .8rem; padding-bottom: .8rem; border-top: 0; }
.cart-item.ofd-bundle-child .cart-item__media { padding-left: 3.2rem; }
.cart-item.ofd-bundle-child .cart-item__image-container { width: 100%; max-width: 5.2rem; }
.cart-item.ofd-bundle-child .cart-item__name { font-size: 1.3rem; line-height: 1.35; }
.cart-item.ofd-bundle-child .product-option,
.cart-item.ofd-bundle-child .cart-item__totals .price { font-size: 1.2rem; }
.cart-item.ofd-bundle-child .cart-item__quantity { padding-top: 0; }
```

**Si ya tenías pegado el CSS anterior**

La receta antigua escondía el selector de la montura y los controles de los complementos con CSS. Ya no hace falta y conviene quitar esas reglas: el selector de la montura ahora sirve (multiplica los complementos, o vuelve a 1 en «Lock»), y los controles de las líneas de complemento se deciden en la incrustación de la app. Las reglas de tamaño de arriba siguen valiendo.

## Split (KrownThemes)

Split tiene su propio panel de carrito y la app lo reconoce sola: no hay que tocar selectores. Dos cosas:

1. En **Tema › Incrustaciones de aplicaciones › Optical Form Drawer**, activa **Compact the add-on lines in the cart** (líneas de complemento sangradas bajo la montura) y, si no quieres que los complementos enseñen el selector de cantidad ni el enlace «Eliminar», pon **Add-ons in the cart** en «Visible without controls». El selector de la montura se queda: multiplica los complementos, o vuelve a 1 si eliges «Lock» en **Set quantity from the cart**. La montura conserva «Eliminar» y al borrarla se lleva las lentes.
2. Si quieres las líneas de complemento más pequeñas y sangradas bajo la montura, pega esto en **Custom CSS** de la misma incrustación de la app:

```css
/* Optical Form · Split — complementos compactos bajo la montura (cajón y página del carrito) */
#AjaxCartForm .cart-item.ofd-bundle-child { padding-left: 24px !important; margin-top: -8px !important; }
#AjaxCartForm .cart-item.ofd-bundle-child .thumbnail { width: 56px !important; flex: 0 0 56px !important; }
#AjaxCartForm .cart-item.ofd-bundle-child .item-title { font-size: 13px !important; line-height: 1.35 !important; }
#AjaxCartForm .cart-item.ofd-bundle-child .item-price { font-size: 12px !important; }
#AjaxCartForm .cart-item.ofd-bundle-child .actions { display: none !important; }
```

Split imprime en el carrito **todas** las propiedades de línea, también las técnicas que empiezan por `_` (les quita el guion bajo), así que bajo la montura y bajo cada complemento verás líneas como `ofd_type: main`. Dos formas de quitarlas:

- **La limpia, en el tema**: en `snippets/cart-form.liquid`, la condición que decide qué propiedad se imprime (`{%- if p.last != blank and p_first_char != '_p_' -%}`) pasa a `{%- if p.last != blank and p_first_char != '_p_' and p.first contains '_ofd_' == false -%}`. Sirve para cualquier orden y cualquier ajuste del formulario.
- **Solo con CSS**, pegando esto debajo del bloque anterior. Vale mientras tengas activa **Unir las selecciones en una sola línea** (Diseño › Líneas del carrito): esa línea va la primera y las técnicas ocupan la segunda, la tercera y la última. Si desactivas la unión, cambia las dos primeras reglas de la montura por `span:nth-child(-n+2)`.

```css
/* Propiedades técnicas (ofd_*): en los complementos, todas; en la montura, la 2.ª, la 3.ª y la última */
#AjaxCartForm .cart-item.ofd-bundle-child .margin-top-xs { display: none !important; }
#AjaxCartForm .cart-item.ofd-bundle-parent .margin-top-xs > span:nth-child(2),
#AjaxCartForm .cart-item.ofd-bundle-parent .margin-top-xs > span:nth-child(3),
#AjaxCartForm .cart-item.ofd-bundle-parent .margin-top-xs > span:last-child { display: none !important; }
```

## Cualquier tema: las clases que deja la integración con el carrito

En todos los temas, la integración con el carrito marca cada fila de un conjunto con su **papel**: `ofd-bundle-parent` en la montura (y `ofd-set-fixed` si es una lentilla, cuya cantidad fija el configurador), `ofd-bundle-child` en cada línea de complemento, más `ofd-bundle-addon` (lentes y tratamientos) o `ofd-bundle-accessory` (líquidos, fundas). Y dentro de cada fila marca los controles que encuentra: `ofd-ctl-qty` en el selector de cantidad (el número con sus botones) y `ofd-ctl-remove` en la papelera. Son las clases que usan los ajustes de la incrustación de la app en los temas medidos, y las que puedes usar tú en cualquier otro, pegado en **Custom CSS**:

```css
/* Optical Form · cualquier tema — por el papel de cada fila del conjunto */
.ofd-bundle-addon .ofd-ctl-qty,
.ofd-bundle-addon .ofd-ctl-remove { display: none !important; }   /* complementos sin controles */
.ofd-bundle-accessory .ofd-ctl-remove { display: none !important; } /* accesorios sin papelera */
.ofd-set-fixed .ofd-ctl-qty { display: none !important; }           /* lentillas sin selector */
/* o, en vez de la primera regla, complementos ocultos del todo: */
/* .ofd-bundle-addon { display: none !important; } */
```

Las marcas de los controles son una heurística (busca el campo numérico con sus botones «+»/«−» y el botón o enlace de eliminar por su etiqueta), pero acotada: solo mira dentro de las filas de un conjunto de Optical Form, así que nunca toca otra línea del carrito ni el resto de la página. Si en tu tema no acierta, escríbenos con el nombre y la versión y lo medimos.

## Cambiar la cantidad desde el carrito

Una montura configurada y sus complementos son **un conjunto**. Si el cliente sube la cantidad de la montura en el carrito de tu tema —el panel o la página—, la app multiplica con ella las lentes y los tratamientos (dos lentes por montura, un tratamiento por montura…), en una sola petición y sin volver a abrir el panel. Si en cambio cambia un complemento por su cuenta, vuelve a su sitio. Los accesorios van libres. Y las **lentillas no se escalan**: sus cajas por ojo se eligen en el configurador, y cualquier cambio en el carrito vuelve a ellas con el aviso «Las cajas por ojo se eligen en el configurador».

Si prefieres que una montura configurada sea siempre una unidad, pon **Set quantity from the cart** en «Lock»: vuelve a 1 con el aviso «Las cantidades del conjunto van juntas. Para otra montura igual, configúrala de nuevo». Los dos avisos están traducidos. Todo esto está medido en Horizon 2.x a 4.2, Dawn 15 y 16 y Split, con y sin descuentos automáticos (un 2×1 reparte la montura en varias líneas y la app las suma).

## Lo que verá tu cliente en cualquiera de los temas

- La montura con su foto, su precio y la configuración elegida.
- La **graduación etiquetada**, con los mismos nombres de campo que el formulario: `OD: SPH -2.25 · CYL -0.75 · AX 90°`, `OI: …`, `DIP: 63`.
- Los complementos debajo, con su precio y su cantidad — o sin controles, u ocultos, según lo que elijas en la incrustación de la app.

Las propiedades técnicas que van al laboratorio (empiezan por `_`) no se ven en ningún tema de Shopify: ni en el carrito, ni en el checkout, ni en el email.

## Tu tema no está en la lista

El formulario y el cobro funcionan igual en cualquier tema: los ajustes automáticos de la incrustación de la app detectan el carrito de la mayoría. Lo que no podemos garantizar sin verlo es **el acabado** del panel del carrito —que los complementos salgan agrupados bajo la montura y pulidos como en Horizon—, porque cada tema muestra sus líneas con su propio código.

Si quieres ese acabado en un tema que no está aquí, escríbenos a support@getoptical.app con el nombre y la versión del tema. Lo normal es que te pidamos **acceso de colaborador** a la tienda (permiso de *Temas*) o, como mínimo, un enlace de vista previa del tema con el formulario activo en un producto. Con eso ajustamos el carrito, te dejamos el CSS listo para pegar y el tema pasa a esta tabla.

---

# El botón del producto

> Cómo dar al botón que abre el configurador el mismo aspecto que los botones de tu tema, en escritorio y en móvil.

Source: https://docs.getoptical.app/guias/boton-del-producto/
Language: es

El botón que abre el configurador vive en la página de producto, así que tiene que parecerse a los demás botones de tu tienda. Se configura en el **editor de temas**, no dentro de la app.

## Dónde se configura

1. En tu admin de Shopify, ve a **Tienda online → Temas → Personalizar**.
2. Abre una página de producto.
3. Pulsa sobre el bloque **Optical Form**.

Todos los ajustes que verás se aplican **solo a ese bloque**, y afectan a todos los productos que usen esa plantilla de producto.

## El botón no hereda nada

Esto es importante y va a contracorriente de lo que uno esperaría: **el botón no coge colores de ningún sitio**. Ni de tu tema, ni de la pestaña *Diseño* del formulario.

Es a propósito. Los temas de Shopify definen sus botones cada uno a su manera, y no hay forma fiable de adivinarlo. En vez de acertar a medias, la app te deja decidirlo todo.

Lo que trae por defecto es un botón **gris muy oscuro con texto blanco**, que es neutro y encaja de forma discreta en casi cualquier tienda hasta que lo ajustes.

**La forma rápida de acertar**

No intentes adivinar los colores de tu tema. Ve a una página de producto de tu tienda, haz clic derecho sobre el botón **Añadir al carrito** y elige *Inspeccionar*. Ahí ves el color exacto. Cópialo y pégalo aquí.

Si eso te suena a chino, hay una alternativa: hazle una captura al botón de tu tema y usa cualquier selector de color (el propio Shopify trae uno en el selector de color) para sacar el tono.

## Contenido

- **Texto del botón** — lo que pone. Si lo dejas vacío, se usa el texto traducido de la app, que se adapta solo al idioma de cada cliente. **Si escribes algo aquí, ese texto sale igual en todos los idiomas.**
- **Icono (opcional)** — una imagen de tu biblioteca de **Archivos**. Va mejor un PNG cuadrado con fondo transparente, de unos 128×128. Déjalo vacío para un botón solo de texto.
- **Posición del icono** — antes o después del texto. Solo aparece cuando hay icono.
- **Separación entre icono y texto** — de 0 a 32 px. Se ignora si la alineación del contenido separa las piezas a los extremos.

## Colores

Seis colores: **fondo**, **texto** y **borde**, cada uno con su versión **al pasar el ratón por encima**.

El borde solo se ve si además le pones un grosor mayor que cero, más abajo. Si dejas el color de borde vacío, no se ve borde aunque tenga grosor.

## Forma y tipografía

Estos valores son **comunes a escritorio y móvil**, porque casi nunca conviene que cambien de un sitio a otro:

- **Radio de las esquinas** — de 0 (cuadrado) a 60 (píldora).
- **Grosor del borde** — 0 significa sin borde.
- **Grosor de la letra**, **espaciado entre letras** y **mayúsculas/minúsculas**.

## Escritorio y móvil por separado

Lo que sí cambia entre pantallas tiene su propio juego de ajustes:

| Ajuste | Para qué |
|---|---|
| **Ajustar al contenido** | El botón ocupa solo lo que mide su texto, en vez de una anchura fija. Es lo habitual en escritorio |
| **Ancho** | Porcentaje del espacio disponible. En móvil casi siempre 100% |
| **Relleno vertical y horizontal** | El espacio entre el texto y el borde del botón. Lo que le da el tamaño |
| **Tamaño de letra** | |
| **Alineación del contenido** | Dónde quedan el icono y el texto dentro del botón: centrados, a la izquierda, a la derecha o separados a los extremos |
| **Tamaño del icono** | De 10 a 48 px. Solo aparece cuando hay icono |

La versión **móvil** se aplica en pantallas de menos de 750 píxeles de ancho, que es el corte estándar de Shopify.

**Cómo previsualizar el móvil**

En el editor de temas, arriba a la izquierda, hay unos iconos de pantalla y de móvil. Pulsa el de móvil y verás cómo queda sin salir del editor.

## Dónde va el botón respecto al de tu tema

Por defecto el botón sale donde pongas el bloque en el editor: encima o debajo del bloque «Buy buttons» de tu tema, en su propia fila. Si lo quieres pegado al botón «Añadir al carrito», usa el ajuste **Position** del bloque, en la sección **Theme integration & placement**:

- **Where the block is placed**: como hasta ahora.
- **Above the theme's add to cart** / **Below the theme's add to cart**: justo encima o justo debajo de la línea del botón de tu tema. «Debajo» queda entre ese botón y los de pago rápido (Shop Pay, PayPal).
- **Side by side, left / right**: los dos botones en la misma línea, mitad y mitad, a la misma altura. **Gap** es la separación con el botón del tema, en cualquiera de las posiciones, y **Stack on mobile** los apila a ancho completo en pantallas estrechas, porque medio ancho en un móvil parte la etiqueta.

No hay que tocar el tema: la app encuentra sola el botón «Añadir al carrito» en los temas que hemos probado. Si en el tuyo no lo encuentra, el botón se queda donde está el bloque y puedes indicarle el selector CSS de tu botón en **Add to cart selector**, o escribirnos. Al lado, el botón toma el ancho de su mitad; los colores, el texto, el icono y la tipografía siguen siendo los del bloque.

## Ajustes avanzados

El campo **Selector de input de variante** está pensado para desarrolladores y **casi nunca hace falta**: solo para temas raros donde la app no detecta qué variante ha elegido el cliente. Déjalo vacío salvo que te lo indique el soporte.

## Cuando la montura está agotada

El botón sigue a la variante como el botón de compra de tu tema. Si la variante que el cliente tiene seleccionada no se puede vender, el botón se muestra **desactivado con el texto «Agotado»**; si cambia a un color con stock, vuelve a activarse sin recargar. En el mismo bloque, bajo **Ajustes avanzados**, el ajuste **When the frame is sold out** deja elegir entre ese botón desactivado y **ocultarlo** del todo. La palabra «Agotado» se cambia en **Diseño › Textos** de cada formulario.

Aunque el cliente consiguiera abrir el configurador con una montura agotada, «Añadir» no la enviaría al carrito: le diría «La montura X está agotada. Elige otra montura».

## Y los demás textos, ¿dónde están?

- El **idioma del panel** de la app: en **Ajustes** dentro de la app. Ver [Idiomas y textos](https://docs.getoptical.app/guias/traducciones/).
- Los **textos del formulario** que ve el cliente: dentro de cada paso, en el editor del formulario.
- Los **colores del configurador** (el panel que se abre): en la pestaña **Diseño** de cada formulario. Ver [Diseño y carrito](https://docs.getoptical.app/guias/diseno-y-carrito/).

---

# Iconos para tus opciones

> Un pack de 28 iconos, gratis y de uso comercial, para que todo el configurador se vea del mismo estilo.

Source: https://docs.getoptical.app/guias/iconos/
Language: es

Cada opción de tu formulario puede llevar una imagen. Si pones una de un sitio y otra
de otro, el configurador se ve remendado — y eso lo nota el comprador aunque no sepa
decir por qué.

Para evitarlo tienes un pack propio: **28 iconos**, dibujados para GetOptical y **gratis
para usar en tu tienda**, con o sin modificaciones. Cubren el catálogo de una óptica de
punta a punta: el tipo de gafa, el índice, el área de visión de una progresiva, los
tratamientos y los complementos.

<p><a href="https://www.getoptical.app/downloads/getoptical-lens-icons.zip"><strong>Descargar el pack (ZIP, 24 KB)</strong></a></p>

## Qué incluye

**Qué está comprando el cliente**

| Icono | Para |
|---|---|
| `glasses-prescription` | Graduadas / monofocal |
| `glasses-progressive` | Progresivas |
| `glasses-reading` | Gafas de lectura |
| `glasses-plano` | Sin graduar |
| `glasses-sun` | Gafas de sol |
| `contact-lenses` | Lentillas |

**Índice de la lente** — el perfil en color marca cuál es. Cuanto más a la derecha, más gruesa.

`index-150` · `index-160` · `index-167` · `index-174`

**Área de visión, para progresivas** — el corredor nítido se ensancha al subir de gama.

`corridor-standard` · `corridor-wide` · `corridor-premium`

**Tratamientos**

| Icono | Para |
|---|---|
| `lens-standard` | Lente estándar |
| `lens-anti-reflective` | Antirreflejante |
| `lens-blue-light` | Filtro de luz azul |
| `lens-photochromic` | Fotocromática |
| `lens-polarised` | Polarizada |
| `lens-tint` | Tintada |
| `lens-driving` | Conducción |
| `lens-mirror` | Espejo |
| `lens-water-repellent` | Hidrofóbico / repelente al agua |
| `lens-scratch-resistant` | Antiarañazos |
| `lens-anti-fog` | Antivaho |
| `lens-uv` | Filtro UV |

**Complementos**

| Icono | Para |
|---|---|
| `addon-case` | Estuche |
| `addon-solution` | Líquido limpiador |
| `addon-cloth` | Gamuza |

Son **SVG**, así que se ven nítidos a cualquier tamaño y pesan unos 500 bytes cada uno.

**Vienen en dos juegos**

La carpeta principal es para **fondos claros**. La carpeta `on-dark/` trae los
mismos iconos con el contorno aclarado, para configuradores de fondo oscuro. Elige el
juego que case con tu diseño: sobre el fondo equivocado el contorno desaparece. La plantilla
de formulario **Gafas de sol · Oscuro** y la plantilla de diseño **Oscura** usan el juego `on-dark/`.

## Cómo ponerlos

1. En tu admin de Shopify, ve a **Contenido → Archivos** y sube los que vayas a usar.
2. Copia la URL de cada archivo.
3. En tu formulario, abre la opción y pégala en **Imagen de la opción**.

**Súbelos a tu tienda, no los enlaces a los nuestros**

Es tentador enlazar directamente a `getoptical.app`. Funciona hoy, pero si algún día
reorganizamos esa carpeta se te quedan las páginas de producto sin imagen. Con los archivos en tu
tienda, eso no puede pasarte.

## Si quieres añadir alguno tuyo

El pack sigue una gramática sencilla, y respetarla es lo que hace que los iconos
parezcan del mismo juego:

- **La lente es siempre la misma elipse** — `cx 72, cy 72, rx 45, ry 36`, con trazo de
  `8`, sobre un lienzo de `144 × 144`.
- **Dentro va el concepto**, y **el color de acento señala el sujeto** del icono.
- **El gris es para lo secundario**, nunca para el sujeto.
- Los índices y las áreas de visión varían una **forma**, no una etiqueta: qué perfil va
  en acento, o cuánto se ensancha el corredor. Sepáralos lo bastante como para que la
  diferencia se note a 40 px, que es el tamaño al que se usan de verdad.
- **Los complementos no llevan elipse.** La elipse significa «esto es una lente», y un
  estuche no lo es.

Colores: contorno `#1F2A28` · acento `#0E6E63` · gris `#7E8E8B`.

## Lo que puedes hacer con ellos

Puedes **usarlos, modificarlos, recolorearlos y publicarlos** en tu tienda y en tu
publicidad, incluidas las tiendas que montes para clientes tuyos. Sin atribución y sin
coste.

Lo único que no puedes es **revenderlos o redistribuirlos como pack de iconos**, por su
cuenta o como el grueso de otro producto.

**Sobre las marcas**

Los iconos son deliberadamente genéricos y no llevan marcas de terceros. No hay un icono
de *Transitions®*, porque es una marca registrada de Transitions Optical. Etiqueta tú
tus opciones con los nombres comerciales que tengas derecho a usar como vendedor de esos
productos — el icono de fotocromática te sirve igual.

---

# Idiomas y textos

> De dónde sale cada texto que ve tu cliente, quién manda sobre quién, y cómo cambiar una etiqueta sin romper los demás idiomas.

Source: https://docs.getoptical.app/guias/traducciones/
Language: es

Esta es la parte que más dudas genera, así que vamos despacio. No hace falta saber nada de programación.

## Primero: dos cosas que se confunden

| | Qué es | Quién lo ve |
|---|---|---|
| **Idioma del panel** | En qué idioma se ve *esta* aplicación cuando entras a trabajar | Solo tú y tu equipo |
| **Textos del formulario** | Las palabras que aparecen en el formulario de tu tienda | Tus clientes |

Son independientes. Puedes tener el panel en español y vender en inglés, o al revés.

### Idioma del panel

En **Ajustes → Idioma** eliges entre *Automático*, *Inglés* o *Español*.

Se guarda **en tu tienda** y se aplica al momento, sin botón de guardar. Es una preferencia de la tienda, no de cada persona: todo tu equipo ve el panel en el idioma que elijas aquí. En *Automático* la app sigue el idioma principal de tu tienda.

## Los textos del formulario: de dónde salen

Aquí está lo importante. Cada texto que ve tu cliente puede venir de **tres sitios distintos**, y cuando dos dicen cosas diferentes, gana uno concreto.

Piénsalo como una escalera. Cada peldaño pisa al de abajo:

```
4. Traducción por idioma (selector de idioma)   ← manda siempre
3. Lo que escribes en las cajas del paso        ← solo si lo cambias
2. El idioma de tu tienda (español, inglés…)    ← lo normal
1. Los textos de fábrica, en inglés             ← el suelo
```

### 1. Textos por defecto

La app trae todos sus textos escritos en inglés. Es el suelo: si nada más los pisa, se ven así.

### 2. El idioma de tu tienda

La app viene traducida. Si tu tienda está en español, tu cliente ve el formulario en español automáticamente, sin que hagas nada.

Esto ya cubre a la mayoría de comercios: **no necesitas tocar nada de lo que viene después.**

### 3. Los campos de texto de cada paso

Dentro de cada paso hay campos donde puedes reescribir las etiquetas: los títulos de cada ojo, los nombres de los campos, los mensajes de error…

Mientras no toques un campo, aparece **vacío y con el texto por defecto en gris** — el mismo que ve tu cliente, en el idioma de tu tienda. Abres un paso de graduación en una tienda española y el campo de la esfera muestra `ESF:` en gris; en una tienda inglesa, `SPH:`. Ese gris no es un valor: es lo que se enseña si no escribes nada.

Solo cuando **escribes algo** en el campo, tu texto pasa a mandar. Si escribes `Esfera:`, tus clientes verán `Esfera:`.

**Si ves texto en inglés escrito en un campo**

Los formularios guardados antes de agosto de 2026 llevaban el texto por defecto en inglés escrito dentro de cada campo (`SPH:`, `Right eye (OD)`…). La app ya lo distingue: un texto idéntico al texto por defecto cuenta como *sin tocar*, así que tu cliente sigue viendo el idioma de la tienda, y al abrir el paso hoy esos campos se ven vacíos con el gris. Si en alguno sigue apareciendo inglés escrito, es que alguien lo cambió a propósito.

**Cuidado con una consecuencia:** lo que escribas ahí se aplica **en todos los idiomas** de tu tienda. Si pones `Esfera:`, un cliente inglés también verá `Esfera:`.

### 4. El selector de idioma

Si vendes en varios idiomas y quieres un texto distinto en cada uno, usa el **selector de idioma** que hay junto al título *Pasos*, en el editor del formulario.

Eliges un idioma, escribes los textos para ese idioma, cambias a otro y escribes los suyos. Cada idioma guarda los suyos por separado.

Esto pisa a todo lo demás, siempre.

### 5. Los textos de la interfaz

Hay palabras que no son de ningún paso sino del propio formulario: **Siguiente**, **Añadir al carrito**, **Resumen**, **Total**, **Incluido**, «Elige un color para continuar», los mensajes de error del carrito… Vienen traducidas con la app y, hasta ahora, no se podían cambiar.

Desde **Diseño › Textos de la interfaz** sí. Ahí está también el **texto del botón de la página de producto** (el que abre el formulario), en el primer grupo. Cada campo muestra en gris lo que ven hoy tus clientes en el idioma elegido, escribes encima para decirlo a tu manera («Pedir mis gafas» en vez de «Añadir al carrito», «Continuar» en vez de «Siguiente») y vacías el campo para volver. Si vendes en varios idiomas, elige el idioma arriba de la sección y escribe los suyos: cada idioma guarda los suyos por separado.

Dos cosas a respetar: los marcadores entre llaves —`{price}`, `{label}`— son donde la app pone el importe o el nombre del paso, y tienen que quedarse; y algunos textos los leen solo los lectores de pantalla (Cerrar, Atrás, el icono de ayuda), así que cámbialos solo si sabes lo que hace un lector.

## Cómo hago…

**…cambiar el nombre de un campo en todos los idiomas**
Escribe el texto nuevo en el campo del paso. Vale para tiendas de un solo idioma, o cuando quieres el mismo término en todos.

**…poner un texto distinto por idioma**
Usa el selector de idioma del editor. Es la única forma de que cada idioma tenga el suyo.

**…volver al texto original**
Vacía el campo: vuelve a verse el gris por defecto, y tu cliente vuelve a ver el idioma de la tienda.

**…dejar un campo en inglés dentro de una tienda española**
Escribe el término en inglés en el campo (por ejemplo `SPH:` en vez del `ESF:` gris). Si quieres que solo lo vean los clientes en español y no los demás idiomas, usa el selector de idioma, elige *español*, y escríbelo ahí.

## Si traes un formulario de otra tienda

Cada formulario tiene un **idioma base**: el de la tienda donde se creó. Es el que ves en el selector marcado como *— Base*.

Al importar un formulario en una tienda cuyo idioma principal es distinto, la app **cambia la base al idioma de tu tienda** y guarda el idioma original como una traducción más. No pierdes ningún texto y no tienes que hacer nada.

Si algún campo no tenía traducción a tu idioma, se queda como estaba en lugar de aparecer vacío: es más útil ver el texto en otro idioma que no ver nada.

**Cómo saber en qué idioma estás editando**

El selector junto al título *Pasos* siempre indica cuál es la base. Si dice **Español — Base**, lo que escribas en los campos es el español; para el resto de idiomas, cambia el selector primero.

Más detalles en [Copiar un formulario a otra tienda](https://docs.getoptical.app/guias/copiar-formulario/).

## Los colores y las ayudas también se traducen

Todo lo que escribes tú dentro de una opción se traduce igual que su etiqueta, con el mismo selector de idioma: el **nombre de cada color**, el **título, la descripción y la ayuda de cada grupo de colores**, y el **texto de ayuda** que aparece tras el «?» junto al título. Lo que no escribes tú —«Elige un color para continuar», el «Desde» del precio, «Incluido»— ya viene traducido; y si lo reescribes en **Diseño**, tu texto se aplica en todos los idiomas.

## Textos que no están en los pasos

Los botones generales del formulario —*Siguiente*, *Anterior*, *Añadir al carrito*, *Total*, los mensajes de error— vienen traducidos con la app y siguen el idioma de tu tienda. No hace falta configurarlos.

**Después de cambiar textos, sincroniza**

Guardar en el editor **no** actualiza tu tienda todavía. Pulsa **Sincronizar ahora** y espera a que el estado diga *Sincronizado*. Hasta entonces tus clientes siguen viendo la versión anterior.

---

# Sincronización y copias

> Publica tus formularios en Shopify vía metaobjects y haz copias de seguridad en JSON.

Source: https://docs.getoptical.app/guias/sincronizacion/
Language: es

## Guardar ≠ Publicar

Editar un formulario en la app y pulsar **Guardar** almacena los cambios, pero **no** los publica en la tienda. Para que lleguen a la tienda hay que **Sincronizar**.

Cada formulario se publica como un **metaobject de Shopify**. La extensión de tema lee ese metaobject para renderizar el panel.

## Sincronizar con Shopify

1. Guarda el formulario.
2. Pulsa **Sincronizar ahora** (o "Sincronizar con Shopify").
3. La sincronización se procesa **en segundo plano**; recarga para ver el estado.

En la pestaña **Ajustes** del formulario verás el estado: **Sincronizado**, **Sin sincronizar** o **Error de sincronización**, y la fecha de la última sincronización.

**Si pone «Error de sincronización»**

Ese formulario **no llegó a publicarse**, así que tu tienda sigue mostrando la versión anterior — o ninguna, si era la primera vez que lo publicabas.

Ábrelo y pulsa **Sincronizar ahora**. Suele tardar unos segundos y con eso se resuelve en la mayoría de los casos.

No has perdido nada: tus pasos, textos y ajustes están guardados. Si vuelve a fallar, escríbenos a **[support@getoptical.app](mailto:support@getoptical.app)** y lo miramos nosotros.

**Recuerda sincronizar tras cada cambio**

Si cambias pasos, precios o diseño y solo guardas, la tienda seguirá mostrando la versión anterior hasta que sincronices.

## Estado del formulario

Un formulario solo aparece en la tienda si está **Activo** *y* **Sincronizado**, y su producto tiene el formulario asignado con la [incrustación de la app](https://docs.getoptical.app/empezar/instalacion/) activada.

## Copia de seguridad y restauración (JSON)

- **Exportar formulario como JSON** (pestaña Ajustes) — descarga toda la configuración del formulario. Úsalo para respaldar o para **copiar el formulario a otra tienda**.
- **Importar desde JSON** (dashboard) — crea un formulario nuevo a partir de un archivo exportado.

Los pasos, textos, traducciones, diseño y los códigos de tu software de óptica viajan enteros. Los **complementos no**, porque están vinculados a productos de una tienda concreta: ver [Copiar un formulario a otra tienda](https://docs.getoptical.app/guias/copiar-formulario/).

Ningún dato se borra al cambiar de plan: tus formularios, sus pasos y sus traducciones se quedan donde están.

**Lo que sí se desactiva si el plan deja de estar al día**

Tus datos siguen intactos, pero el configurador **deja de mostrarse en tu tienda**, aunque dentro de la app el formulario siga figurando como **Activo**. No es un fallo de sincronización: es el plan.

Al regularizar el pago vuelve con tu configuración exactamente como la dejaste: en cuanto vuelvas a sincronizar el formulario, o solo, en la comprobación diaria.

---

# Copiar un formulario a otra tienda

> Qué viaja dentro del archivo JSON, qué no puede viajar por más que quieras, y qué hacer al llegar.

Source: https://docs.getoptical.app/guias/copiar-formulario/
Language: es

Puedes llevarte un formulario entero de una tienda a otra, o guardarlo como copia de seguridad. Se hace con un archivo, sin tocar código.

Esta página explica **qué se copia y qué no**, porque hay una parte que no puede viajar y saberlo de antemano te ahorra un rato de confusión.

## Cómo se hace

1. En la tienda de origen, abre el formulario → pestaña **Ajustes** → **Exportar formulario como JSON**. Se descarga un archivo.
2. En la tienda de destino, ve al panel principal → **Importar desde JSON** → elige ese archivo.

Listo. Aparece un formulario nuevo con el mismo nombre y la palabra *(imported)* al final.

**Llega siempre como borrador**

El formulario importado entra en estado **Borrador**, nunca activo. Es a propósito: así lo revisas antes de que lo vea un cliente.

## Qué viaja y qué no

| | ¿Viaja? |
|---|---|
| Los pasos, en su orden | ✅ Sí |
| Las opciones de cada paso, con sus textos y descripciones | ✅ Sí |
| Las traducciones a otros idiomas | ✅ Sí |
| Los saltos entre pasos (la lógica condicional) | ✅ Sí |
| Los rangos de graduación y las etiquetas | ✅ Sí |
| Los colores, tamaños y ajustes de diseño | ✅ Sí |
| Los códigos de tu software de óptica (ERP) | ✅ Sí |
| **Los complementos y los productos de accesorios** | ⚠️ Solo si existen en la tienda de destino |
| La asignación a productos y colecciones | ❌ No |

## Qué pasa con los complementos

Un complemento no es un texto: es **un producto concreto de tu tienda**. Por dentro se guarda como un número de identificación que Shopify le asigna a ese producto **en esa tienda y en ninguna otra**.

Esos números no se repiten entre tiendas. Nunca. Aunque crees un producto con el mismo nombre, el mismo precio y la misma foto, su número será distinto.

Así que al importar, la app **comprueba uno por uno** si esos productos existen aquí:

- **Copiar dentro de la misma tienda** (duplicar un formulario, restaurar una copia de seguridad): los números son válidos, así que **los complementos se conservan enteros**.
- **Copiar a otra tienda**: los que no existen aquí **se quitan**, y el aviso al terminar te dice cuántos enlaces se han quitado. Las opciones y los pasos siguen intactos: lo único que se cae es el vínculo al producto.

**Por qué se quitan, y no se dejan «por si acaso»**

Un número de producto de otra tienda no da un error suave. Shopify rechaza **la petición entera** de añadir al carrito, así que tu cliente se queda **sin nada**: ni la montura. Y si el complemento cuelga de una opción, no lo verías venir — simplemente todo el que eligiera esa opción dejaría de poder comprar.

**Prepara los productos antes de importar**

Si ya sabes qué complementos vas a querer (tipos de lente, tratamientos, montaje…), créalos en la tienda de destino **antes** de importar. Así los vinculas del tirón, sin ir y volver.

## Los códigos de tu software de óptica sí viajan

Si en la pestaña **Integraciones** tienes puestos los códigos con los que tu software de gestión (Gesvisión u otro) identifica cada lente y cada tratamiento, esos códigos **viajan dentro del archivo**, igual que los textos.

Son la excepción a la regla de los complementos: un código de ERP no es un número que asigne Shopify, es una etiqueta tuya, así que significa lo mismo en cualquier tienda.

**Si importaste antes de agosto de 2026, vuelve a importar**

Las versiones anteriores de la app se dejaban esos códigos por el camino: el formulario llegaba entero pero **sin la integración**, y los pedidos salían sin la referencia que espera tu software. Si te pasó, exporta de nuevo desde la tienda de origen e importa otra vez.

Lo que la app **no** hace es inventárselos. Si el archivo no trae códigos, llegan vacíos y los rellenas tú: son tuyos y de tu proveedor, y nadie más puede adivinarlos.

## Si ves un aviso de "productos que ya no existen"

Puede pasar con formularios importados de versiones antiguas, o si alguien borró un producto de Shopify que estaba vinculado.

Es un aviso naranja arriba del formulario, y trae un botón **Quitar referencias borradas**.

- Si los productos que menciona **de verdad ya no existen** en tu tienda, pulsa el botón: limpia esas referencias y deja el formulario sano.
- Si te suenan y **crees que sí existen**, no pulses nada y escríbenos. El botón borra los complementos de las opciones, y si el aviso estuviera equivocado perderías configuración.

## El idioma se ajusta solo

Cada formulario tiene un idioma "principal" que es el de la tienda donde se creó. Si copias un formulario de una tienda española a una inglesa, la app **cambia la base al idioma de la tienda de destino** durante la importación, y guarda el idioma original como traducción.

No pierdes ningún texto y no tienes que hacer nada. Si en la tienda de destino falta la traducción de algún campo, ese campo se queda como estaba en lugar de vaciarse.

Para entender de dónde sale cada texto, mira [Idiomas y textos](https://docs.getoptical.app/guias/traducciones/).

## Los formularios de ejemplo

**Al instalar la app ya tienes cuatro**, en borrador, sin que hagas nada:

- **Gafas graduadas · pantalla completa** — los 11 pasos de una óptica a pantalla partida, con colores de tratamiento de muestra (sin producto detrás: cámbialos por tus tintes).
- **Gafas graduadas** — los mismos 11 pasos en panel lateral: tipo de gafas, grosor de la lente, aumento de lectura, tratamientos, cómo nos das tu graduación, la graduación, el resumen, la subida de receta y los accesorios.
- **Gafas de sol · oscuro** — solo sol o graduadas, tinte, polarización y accesorios, con la plantilla de diseño Oscura.
- **Lentillas** — los 3 pasos de una venta de lentillas: tipo de lentilla, graduación por ojo y complementos de cuidado.

Los cuatro llegan **en el idioma de tu tienda** y en **borrador**, así que no aparecen en ninguna página de producto hasta que tú los actives.

**Vienen sin complementos a propósito**, por lo que acabas de leer. Ábrelos, recorre los pasos, y ve vinculando tus productos en las opciones donde quieras cobrar un extra.

## Después de importar, en este orden

1. **Revisa los pasos** y ajusta los textos a cómo hablas tú de tus lentes.
2. **Vincula tus complementos** en las opciones que lleven precio.
3. **Asigna el formulario** a tus productos o colecciones, en la pestaña *Productos*.
4. Pon el estado en **Activo**.
5. Pulsa **Sincronizar ahora** y espera a que diga *Sincronizado*.

**Sin sincronizar no se ve**

Guardar guarda, pero no publica. Hasta que sincronices, tus clientes no verán el formulario nuevo. Lo mismo cada vez que cambies algo.

---

# Leer la analítica

> Qué significa cada cifra de la pestaña Analítica, qué es la señal «aquí se quedan» y qué tocar en tu formulario según el paso que pierde clientes.

Source: https://docs.getoptical.app/guias/analitica/
Language: es

La pestaña **Analítica** del admin cuenta qué hacen tus clientes con el configurador: cuántos lo abren, cuántos llegan al carrito y en qué paso se quedan los que no. Esta guía explica cada cifra y, sobre todo, qué hacer con ella.

## Dónde está y qué periodo mira

En el menú de la app, **Analítica**. Arriba eliges el periodo: últimos 7, 30 o 90 días. Cada cifra se compara con el periodo anterior de la misma duración, y ese es el número pequeño con la flecha. Las cifras se recalculan como mucho cada diez minutos: si acabas de probar el configurador, dale ese margen antes de buscarte en el embudo.

## Las cuatro cifras de arriba

- **Lo abrieron.** Clientes distintos que abrieron el configurador. Un cliente que lo abre tres veces cuenta una.
- **Llegaron al carrito.** Clientes que terminaron y añadieron su pedido.
- **Conversión.** De los que abren, cuántos terminan. En las tiendas que medimos se mueve entre el 20 y el 30 por ciento; por debajo del 20 casi siempre hay un paso que pierde gente, y el embudo te dice cuál.
- **Tiempo típico.** Lo que tarda un cliente en completarlo, en mediana: la mitad tarda menos, la mitad más. Entre uno y dos minutos es normal con cinco pasos.

Debajo, y solo cuando ha ocurrido, una línea en rojo: **Errores al añadir al carrito: N**, con el desglose por causa — montura agotada, complemento no disponible, límite de stock en el carrito, tienda ocupada. Cada uno es un cliente que terminó el formulario y no pudo comprar. Un «complemento no disponible» repetido es un tratamiento o un accesorio sin stock o en borrador: revísalo en el editor con **Comprobar precios**.

## Día a día

El gráfico enseña aperturas y llegadas al carrito por día, con el periodo anterior en línea discontinua. Sirve para ver si un cambio en el formulario o una campaña movió algo, no para leer un día suelto: con pocas visitas cualquier día parece una tendencia.

## Dónde se quedan

Un embudo por formulario. Cada barra es un paso: cuántos clientes llegaron a él y, en rojo, cuántos cerraron el configurador estando justo ahí. Lo que importa no es el rojo en bruto sino la proporción: un paso al que llegan 10 y pierde 5 es peor que uno al que llegan 500 y pierde 20.

Los pasos se nombran con la etiqueta que les diste en el editor. Un paso que borraste sigue apareciendo mientras tenga datos, marcado como eliminado.

## La señal: «aquí se quedan»

Sobre el embudo de cada formulario, la app te señala **el paso que más pierde** en proporción a los que llegan, y te dice qué tocar. Para no señalar ruido, solo aparece cuando al paso han llegado **al menos 20 clientes** y **se va el 25 por ciento o más** de ellos. Con menos datos verás «todavía pocos datos» y el número de sesiones que llevas; con datos suficientes y ningún paso por encima del umbral, «ningún paso pierde más del 25 por ciento».

La señal trae dos botones: **Editar el formulario**, que abre ese formulario en el editor, y **Cómo mejorarlo**, que trae aquí.

La misma señal, la mayor de todos tus formularios, aparece también en el **Home** de la app, debajo de tus formularios. Puedes descartarla; si otra semana la señal cambia de paso, vuelve a aparecer.

## Qué tocar según el paso que pierde

**Un paso de elección** (tipo de lente, índice, tratamiento, color). Es donde más gente se va, y casi siempre por la misma razón: tiene que decidir algo que no domina, y ve el precio. Deja tres o cuatro opciones y marca la que recomiendas con la etiqueta «Recomendada» (botón **Elegir etiqueta** en la opción; el cliente ve la etiqueta junto al nombre). Añade un texto de ayuda a las que confunden, dales un icono del pack y enseña el precio como suplemento sobre lo anterior, no como un total nuevo. Ver [Crear un formulario](https://docs.getoptical.app/guias/crear-formulario/), [Iconos](https://docs.getoptical.app/guias/iconos/) y [Precios y cobro](https://docs.getoptical.app/guias/precios-y-cobro/).

**El paso de graduación** (gafas, lectura o lentillas). Quien no tiene la receta a mano se va. Haz opcionales la adición y la distancia pupilar, pon un ejemplo de receta en el texto de ayuda y ofrece la alternativa de subir una foto de la receta con un paso de subida de archivo. Ver [Graduación y receta](https://docs.getoptical.app/guias/graduacion/) y [Subida de archivo](https://docs.getoptical.app/guias/subir-receta/).

**El resumen de la receta.** Es donde el cliente ve por primera vez todo junto y el total. Revisa que cada línea tenga un precio que se entienda y que el botón diga exactamente lo que va a pasar.

**La subida de archivo.** Acepta imagen y PDF, di qué formatos y qué tamaño valen, y deja saltarla: si es obligatoria y el cliente no tiene la receta a mano, se va.

**Accesorios y extras.** Son opcionales: no los marques por defecto y enseña el suplemento de cada uno. Si la gente se va justo aquí, lo que sorprende es el precio. Ver [Complementos y accesorios](https://docs.getoptical.app/guias/accesorios-y-addons/).

**Un campo de texto.** Un campo de texto obligatorio frena. Hazlo opcional o convierte la pregunta en opciones.

Después de cada cambio, espera 30 días y vuelve a mirar el mismo embudo. Es la única manera de saber si el cambio sirvió.

## Lo que más eligen

La tabla de abajo cuenta, solo de pedidos terminados, qué opciones se eligieron más veces. Es la respuesta a «¿merece la pena la opción cara?» y a «¿alguien elige esto?». Los pasos de receta no entran nunca.

## Lo que no se mide

Estas cifras son anónimas. La app no guarda ninguna graduación, ningún archivo ni ningún dato del cliente, y las cifras no salen de tu tienda: nadie más las ve. Los datos se conservan 195 días y después se borran solos; el embudo de un periodo que ya no existe no se puede recuperar.

Si quieres cruzar estas cifras con tu propia analítica o tu chat, el configurador emite eventos en el navegador para eso: [Qué hacer con cada evento](https://docs.getoptical.app/desarrolladores/eventos/).

---

# Cuando algo no funciona

> Busca tu síntoma, sigue las comprobaciones en orden y para en cuanto una falle. Sin tecnicismos.

Source: https://docs.getoptical.app/guias/cuando-algo-no-funciona/
Language: es

Busca abajo **lo que ves** y sigue las comprobaciones **en el orden dado**. Están ordenadas de la causa más frecuente a la más rara, así que para en cuanto una falle: esa es.

---

## No veo el botón en la página de producto

El caso más común, y casi siempre es una de las cinco condiciones que hacen falta a la vez.

**1. ¿La Guía de configuración está al 6/6?**
Ábrela en el inicio de la app. Si algún paso está pendiente, ahí tienes la respuesta — sigue ese paso y vuelve.

**2. ¿El formulario está Activo *y* Sincronizado?**
Ajustes del formulario. Hacen falta **las dos** cosas. *Activo* pero *Sin sincronizar* significa que tus cambios aún no han salido a la tienda: pulsa **Sincronizar ahora** y espera al verde.

**3. ¿Este producto tiene formulario asignado?**
Pestaña **Productos** del formulario. Un formulario perfecto sin asignar no aparece en ninguna parte. Si lo asignaste por **colección**, comprueba que el producto está realmente en esa colección y que la colección está **publicada en Tienda online**: las que no lo están no muestran el formulario ([Productos y colecciones](https://docs.getoptical.app/guias/productos-y-colecciones/)).

**4. ¿El bloque está en la plantilla que usa este producto?**
Esta es la que más despista. Si tienes varias plantillas de producto, el bloque hay que añadirlo **en cada una**. Mira en el producto, barra lateral derecha, **Plantilla de tema**, cuál usa — y comprueba que el bloque está en esa.

**5. ¿Estás mirando el tema publicado?**
Los ajustes de tema no se comparten entre temas. Si añadiste el bloque a un borrador, en el tema en vivo no está.

**Atajo**

Cambiar de tema **borra** la incrustación y el bloque, porque son ajustes del tema. Si el botón desapareció justo después de cambiar o actualizar el tema, es eso: la Guía te lo marcará en rojo.

---

## Veo dos botones iguales

Añadiste el bloque dos veces. Pasa con facilidad: el enlace de la Guía **ya deja el bloque puesto** en el editor, así que si además añades otro a mano, quedan dos.

En el editor de temas, sobre la plantilla de producto, borra el que sobre y guarda.

---

## El botón sale, pero al pulsarlo no pasa nada

Casi siempre es que **la incrustación está desactivada**. El botón lo muestra un bloque, pero el formulario lo carga la incrustación: sin ella, hay botón pero no se abre nada.

Ve a la Guía de configuración y comprueba el paso **"Activa la incrustación de la app"**. Si está en verde y sigue sin abrir, escríbenos con el nombre y la versión de tu tema.

---

## Elijo una variante y el carrito recibe otra

Por ejemplo, eliges el color negro y llega el azul.

El formulario lee la variante en el momento de abrirlo **y otra vez al añadir al carrito**, así que cambiar de variante con el formulario abierto es seguro.

Si aun así falla, tu tema anuncia la variante de una forma poco común. Tiene arreglo sin tocar código: en los ajustes del bloque hay un campo para indicárselo. **Escríbenos con la URL del producto** y te decimos exactamente qué poner.

---

## Añado al carrito y el carrito no se entera

El pedido **sí** se ha añadido —compruébalo abriendo el carrito— pero la pantalla no se actualiza sola.

1. Recarga la página y mira el carrito. Si el producto está, es un problema de refresco visual, no de venta.
2. En los ajustes de la incrustación, comprueba que **«Mantener el carrito sincronizado»** está activado.
3. **Tu tema es Dawn y el panel del carrito se abre vacío o en blanco**, aunque al cerrarlo y volver a abrirlo (o al recargar) sí salen las líneas: es un fallo nuestro ya corregido. Asegúrate de tener la última versión de la app (los temas la cargan solos; basta recargar la tienda) y, si sigue igual, escríbenos con el nombre y la versión de tu tema.
4. Si tu tema es poco habitual, en el apartado **Avanzado** de la incrustación hay campos para indicarle dónde está tu carrito. Escríbenos antes de tocarlos: normalmente no hacen falta.

---

## Los tratamientos salen sueltos en el carrito

Deberían verse **debajo de la montura**, indentados, como parte del conjunto.

Cuando salen como líneas independientes, es que tu tema muestra el carrito de una forma que la app no reconoce. **No afecta a la venta**: los precios, el pedido y el checkout son correctos; solo se ve peor.

Escríbenos con el nombre del tema. Suele resolverse con unas líneas en **Custom CSS**.

---

## El cliente puede cambiar la cantidad de un tratamiento

**Es a propósito, no es una avería.** La app coloca las líneas de tratamiento debajo de la montura, pero **no les esconde ni la cantidad ni la papelera**.

El motivo: esconder un botón no impide la acción —quien quiera puede cambiar esa línea igual desde la API del carrito— y esa misma fila la usan otras apps para garantías y seguros de envío; taparles la papelera dejaría a tu cliente con un cargo ajeno que no puede quitar.

Lo que sí está garantizado siempre: **borrar la montura borra todo su conjunto**, lo muestre como lo muestre el tema.

Si lo que quieres es que esas líneas pesen menos visualmente, activa **Compactar las líneas de complementos** en la incrustación de la app. Ver [Diseño y carrito](https://docs.getoptical.app/guias/diseno-y-carrito/).

---

## Los precios del formulario no cuadran con los de la página de producto

1. ¿Estás mirando la **misma variante**? Los precios cambian por variante.
2. ¿Tienes **varios países o monedas** activos? Comprueba desde el mismo país que el cliente.
3. Si tienes descuentos automáticos, recuerda que muchos se aplican **en el checkout**, no en el carrito.

---

## Sale en el idioma equivocado

**El formulario entero en otro idioma:** revisa [Idiomas y textos](https://docs.getoptical.app/guias/traducciones/). Lo más habitual es haber escrito un texto en los campos del paso, que **se aplica a todos los idiomas**.

**Solo el botón:** si escribiste algo en *Texto del botón* (en el bloque del tema o en Diseño › Textos de la interfaz), ese texto se usa tal cual en todos los idiomas. **Déjalo vacío** y se traduce solo.

**Un formulario traído de otra tienda:** al importarlo se ajusta al idioma de tu tienda automáticamente. Si algún campo no tenía traducción, se queda en el idioma de origen — edítalo con el selector de idioma.

---

## Un aviso naranja dice que faltan productos

*"N productos referenciados ya no existen en tu catálogo"*.

Significa que algún tratamiento o accesorio vinculado a una opción se ha borrado de Shopify.

- Si **de verdad los borraste**, pulsa **Quitar referencias eliminadas**.
- Si **te suenan y crees que siguen existiendo**, no pulses nada y escríbenos. Ese botón borra los complementos de las opciones, y si el aviso fuera equivocado perderías configuración.

---

## El cliente ve «X no está disponible ahora mismo»

Al pulsar «Añadir», el panel explica por qué Shopify no aceptó el pedido, en el idioma de la tienda:

- **«La montura X está agotada. Elige otra montura.»** — la variante elegida no tiene stock. El botón de la página de producto debería salir ya como «Agotado»; si no, revisa [el botón del producto](https://docs.getoptical.app/guias/boton-del-producto/#cuando-la-montura-está-agotada).
- **«X no está disponible ahora mismo. Avisa a la tienda para que lo revise.»** — un tratamiento, un color o un accesorio del formulario está sin stock, en borrador, archivado o fuera del canal Tienda online. Es tuyo de arreglar: abre el formulario y, en la pestaña **Pasos**, mira las etiquetas «Agotado», «Borrador» o «No está en Tienda online» (salen solas al abrir; **Comprobar precios** las vuelve a leer).
- **«Ya tienes el máximo disponible de X en el carrito.»** — el cliente ya tiene en el carrito todas las unidades que quedan.
- **«X ya no está disponible. Vuelve atrás y elige otra opción.»** — una opción que el cliente ya había elegido ha dejado de poder venderse: se ha agotado, o su producto está en borrador, archivado, fuera del canal **Tienda online** o eliminado. Sale en cuanto la app lo sabe, sin esperar a «Añadir»: el panel le quita esa respuesta y, si el paso la exige, no le deja seguir hasta que elija otra. Abre el formulario: el editor marca con una etiqueta qué producto es.
- **«No se encontró la variante»** (en el idioma de tu tienda) — un producto vinculado en el formulario no está en el canal **Tienda online**, o se ha borrado. Shopify no dice cuál, y rechaza también la montura. Ya es raro llegar aquí: el panel muestra esas opciones como «Agotado» antes de que nadie las elija, el editor te avisa al abrir el formulario y, si Shopify rechaza el añadido sin explicarlo, el panel vuelve a consultar y nombra la opción en vez de enseñar esta frase. Si la ves, revisa los productos de las opciones elegidas y [ponlos en el canal](https://docs.getoptical.app/empezar/antes-de-empezar/#cómo-poner-un-producto-en-el-canal-tienda-online).
- Cualquier otra frase es la de Shopify tal cual.

Analítica cuenta estos casos en **Errores al añadir al carrito**.

---

## Cambié algo y en la tienda sigue igual

Guardar **no** publica. Pulsa **Sincronizar ahora** en el formulario y espera a que ponga *Sincronizado*.

Si dice *Error de sincronización*, vuelve a intentarlo. Si insiste, escríbenos con el nombre del formulario.

---

## Cuando escribas a soporte

Cuanto más de esto nos mandes, antes lo resolvemos:

- **URL del producto** donde falla (y la contraseña de la tienda si está protegida)
- **Nombre y versión del tema**
- **Qué esperabas y qué pasó**
- Una **captura** o un vídeo corto
- Si sabes hacerlo: activa el **Modo depuración** en los ajustes de la incrustación, repite el fallo, abre la consola del navegador (F12) y cópianos lo que salga

Ese último punto es el que más acelera las cosas: nos dice exactamente por dónde pasó la app antes de fallar.

**[support@getoptical.app](mailto:support@getoptical.app)**

---

# Planes y facturación

> Planes de Optical Form, prueba gratis de 14 días y 0% de comisión.

Source: https://docs.getoptical.app/facturacion/planes/
Language: es

Optical Form cobra un **precio fijo** y **0% de comisión** sobre tus ventas. La facturación es a través de **Shopify App Pricing**: eliges y cambias de plan en la propia página de Shopify, y el cargo aparece en tu factura de Shopify.

## Planes

| Plan | Precio | Incluye |
|---|---|---|
| **Pro** | $49/mes o $490/año | Todo lo que la app hace hoy: gafas graduadas, **lentillas** y configuradores ilimitados |
| **Plus** *(próximamente)* | $99/mes o $990/año | + guardar y reutilizar la graduación, recompra, suscripciones de lentillas y soporte prioritario |

Pagando al año te ahorras dos meses. Todos los planes incluyen **prueba gratis de 14 días**. Los precios están en **USD**.

## Prueba gratis

Los 14 días van asociados a la **suscripción**, no a la instalación: el contador empieza el día que eliges plan en Shopify. Mientras te lo piensas no gastas prueba.

Los 14 días no generan cargo por adelantado. Cancela antes de que terminen y no se te cobra nada.

## Qué pasa desde que instalas

Hay **dos periodos distintos**, y conviene no confundirlos: los **14 días de bienvenida**, que empiezan al instalar, y los **14 días de prueba**, que empiezan al elegir plan. No se solapan ni se restan: puedes usar los primeros enteros y después tener los segundos completos.

| Momento | Qué pasa |
|---|---|
| **Día 0 — instalas** | Todo funciona, **sin elegir plan**: puedes crear y editar formularios, asignarlos y publicarlos en tu tienda. Ya tienes cuatro formularios de ejemplo en borrador. En el Home verás un aviso amarillo con la fecha en que termina la bienvenida y los días que quedan. |
| **Día 3** | Si aún no has elegido plan, te escribimos un correo para recordarte que los días de prueba no han empezado a contar. |
| **Día 11** | Segundo correo, con la fecha en que se acaba la bienvenida. |
| **Día 14 — se acaba la bienvenida** | Tus configuradores dejan de mostrarse en la tienda y los formularios ya no se pueden editar. **No se borra nada**: formularios, pasos, complementos y ajustes se conservan tal cual, y vuelven a publicarse en cuanto elijas plan. |
| **Eliges plan — el día que quieras** | Se abre la página de Shopify y apruebas el cargo. Empiezan tus **14 días de prueba** sin cobro. Cancela antes de que terminen y no pagas nada. |
| **Día 15 de la prueba** | Shopify te cobra $49 (o $490 si elegiste el año) en tu factura de Shopify. |

Dos detalles que ahorran sorpresas:

- **Desinstalar y volver a instalar no reinicia los 14 días de bienvenida**: cuentan desde la primera instalación.
- Shopify recuerda los días de prueba consumidos durante 180 días: si usas 10 días de prueba, cancelas y vuelves dos meses después, te quedan 4, no 14.

Para elegir plan: dentro de la app, en **Plan y facturación**, pulsa **Ver planes y precios**. Se abre la página de Shopify donde apruebas el cargo — es la única puerta al pago. Al aprobarlo, Shopify te devuelve al Home de la app: durante unos segundos verás **«Activando tu plan…»** mientras confirmamos la suscripción con Shopify, y después tu plan activo y tus configuradores publicados de nuevo.

## Agencias y tiendas de desarrollo

Si montas la tienda para un cliente desde una tienda de desarrollo de Shopify Partners, **Pro no te cuesta nada ahí** y el reloj de la bienvenida deja de correr en cuanto lo eliges. Cómo funciona, y qué pasa al pasar a la tienda real, en [Agencias y tiendas de desarrollo](https://docs.getoptical.app/desarrolladores/tiendas-de-desarrollo/).

## Cambiar de plan

Puedes subir, bajar de plan o cancelar en cualquier momento desde Shopify — sin contactar a soporte.

## Sin comisión

No cobramos ningún porcentaje de tus ventas. El precio del plan es lo único que pagas — te quedas el 100% de cada venta.

---

# Integración con el tema

> Cómo Optical Form se instala de forma agnóstica al tema, sus hooks y la agrupación del carrito.

Source: https://docs.getoptical.app/desarrolladores/integracion/
Language: es

Optical Form funciona en **cualquier tema con Online Store 2.0** —los que permiten añadir bloques desde el editor de temas— y no necesita desarrollador para instalarse. Está verificado en **Dawn** y **Horizon**; para temas a medida hay adaptadores y los hooks de abajo. Esta página resume la capa de integración para quien quiera personalizarla. Para los ajustes visuales del bloque y de la incrustación, ver [Botón y carrito (tema)](https://docs.getoptical.app/desarrolladores/boton-y-carrito/).

## Resolución de variante (agnóstica al tema)

El panel y el botón son web components independientes que **no** se re-renderizan al cambiar de variante. Por eso Optical Form resuelve la variante actual **de forma perezosa** (al abrir y al añadir al carrito), con esta cadena de prioridad:

1. Hook del comerciante: `window.OpticalFormHooks.getVariantId(triggerEl)`
2. Selector configurable en el bloque (setting *Variant input selector*)
3. Input estándar del formulario de producto `[name="id"]` (Dawn/Horizon y la mayoría)
4. Parámetro de URL `?variant=`
5. Fallback al valor renderizado por el servidor

## Plan de suscripción (apps de suscripciones)

El configurador no muestra ningún selector de planes: el cliente elige el plan en la página de producto, con la app de suscripciones que tenga la tienda (Shopify Subscriptions, Appstle o cualquier otra), y Optical Form **lleva esa elección** al carrito. Se resuelve al añadir, en este orden:

1. Hook del comerciante: `window.OpticalFormHooks.getSellingPlanId(triggerEl)`
2. Un `[name="selling_plan"]` dentro del formulario de producto **de este producto** (`form[action*="/cart/add"]` cuyo `[name="id"]` es una de sus variantes): radio marcado, `<select>` o input oculto; lo que haya es la respuesta, también «compra única» (vacío)
3. Cualquier `[name="selling_plan"]` de la página (Appstle muestra sus radios en un bloque de app fuera del formulario)

El plan va **solo en la línea principal** (complementos y accesorios son compra única) y solo si la variante tiene ese plan asignado: el panel enseña el precio del plan en el pie, los botones y el resumen, y el carrito cobra ese mismo importe. Si la app de suscripciones parchea `fetch` (Appstle lo hace), escribe el mismo valor que ya enviamos.

## Hooks (sin forkear la app)

```js
window.OpticalFormHooks = {
  // Devuelve el id de la variante seleccionada (máxima prioridad).
  getVariantId(triggerEl) { return /* id de variante */; },
  // Opcional: sobrescribe el precio (en céntimos) de una variante.
  getVariantPrice(variantId, triggerEl) { return undefined; },
  // Opcional: el id del plan de suscripción elegido (máxima prioridad); undefined = leerlo de la ficha.
  getSellingPlanId(triggerEl) { return undefined; },
  // Opcional: desactiva la agrupación de bundle en el carrito.
  disableCartGrouping: false,
};
```

## Agrupación en el carrito

Los complementos y accesorios se añaden como líneas separadas con `parent_id` (bundle nativo de Shopify — necesario para el borrado en cascada, el checkout y los emails de pedido). Como los temas las muestran como líneas sueltas, **CartBridge** las **reordena** para que cada línea de complemento quede justo debajo de su línea principal y marca cada fila con su papel: `ofd-bundle-parent` (y `ofd-set-fixed` si es una lentilla), `ofd-bundle-child` más `ofd-bundle-addon` o `ofd-bundle-accessory`; y dentro de la fila, `ofd-ctl-qty` en el selector de cantidad y `ofd-ctl-remove` en la papelera.

**Las cantidades del conjunto las cuadra la integración con el carrito**, no el CSS: las líneas agrupadas de Shopify no siguen a su línea principal, así que cuando el cliente sube la montura desde el carrito, CartBridge multiplica los complementos con ella en un solo `POST /cart/update.js` (con las secciones del tema en la misma respuesta), devuelve a su sitio un complemento cambiado por su cuenta, deja libres los accesorios y devuelve una lentilla a sus cajas. Emite `optical-form:cart:resync` con lo que ha cambiado (ver [Eventos](https://docs.getoptical.app/desarrolladores/eventos/)). Con «Bloquear» la montura vuelve a 1. Una sola pasada por cambio, nunca un bucle, nunca añade nada.

Por defecto **la app no envía ni una regla de CSS al carrito**: qué controles enseña cada fila lo decide el comerciante en la incrustación de la app (**Complementos en el carrito**, **Ocultar el botón de eliminar de los accesorios**, **Ocultar el selector de cantidad de las lentillas**), y esas reglas solo alcanzan a las filas de un conjunto de Optical Form: la papelera de otras apps (garantías, seguros de envío) no se toca. Para afinar el aspecto: la casilla **Compactar las líneas de complementos** (`cart_tidy_addons`, desactivada por defecto) y el campo **CSS personalizado**. Ver [Diseño y carrito](https://docs.getoptical.app/guias/diseno-y-carrito/) y [Temas probados](https://docs.getoptical.app/guias/temas-probados/#cualquier-tema-las-clases-que-deja-la-integración-con-el-carrito).

Los selectores del carrito y el comportamiento tras añadir se ajustan en la incrustación de la app — ver [Botón y carrito](https://docs.getoptical.app/desarrolladores/boton-y-carrito/). CartBridge **autodetecta** los patrones de la mayoría de temas; solo hace falta sobrescribir selectores en temas no estándar.

## Eventos del configurador

Los hooks de arriba van hacia dentro: el tema responde a lo que la app pregunta. Estos eventos van al revés — **la app cuenta lo que está haciendo el comprador**, para que tu analítica, tu chat o tu recuperación de carritos vivan donde ya viven, sin necesitar una función nuestra.

No hay que hacer nada para tenerlos. Si nadie escucha, no pasa nada. Qué montar encima de cada uno, con ejemplos para chat, analítica y abandono: [Qué hacer con cada evento](https://docs.getoptical.app/desarrolladores/eventos/).

```js
document.addEventListener('opticalform:step:rendered', (e) => {
  gtag('event', 'lens_configurator_step', {
    step_type: e.detail.stepType,
    step_index: e.detail.stepIndex,
    session_id: e.detail.sessionId,
  });
});
```

Se emiten sobre `<optical-form-drawer>` y **burbujean**, así que puedes escuchar en el elemento o en `document`.

| Evento | Cuándo | Campos propios |
|---|---|---|
| `opticalform:open` | se abre el configurador | — |
| `opticalform:step:rendered` | el comprador llega a un paso | `isFirst`, `isLast` |
| `opticalform:validation:error` | un paso le impide avanzar | — |
| `opticalform:addtocart:start` | empieza el añadido | — |
| `opticalform:addtocart:success` | el carrito lo aceptó | `lineCount`, `totalPrice`, `currency`, `sellingPlanId` (o `null`) |
| `opticalform:addtocart:error` | falló | `kind` |
| `opticalform:close` | se cierra | `completed` |
| `optical-form:cart:orphan` | en el carrito falta alguna línea del conjunto de una montura: el cliente borró las lentes desde el carrito del tema | `groupId`, `key`, `expected`, `actual` |

El último no lo emite el configurador sino la integración con el carrito, en `document`, en cuanto detecta una montura sin las lentes o tratamientos con los que salió: la fila recibe además la clase `ofd-bundle-orphan` y un aviso traducido debajo. La app no borra nada ni bloquea el checkout — con el evento decides tú (avisar a tu chat, quitar la montura, lo que quieras). Mientras la integración con el carrito recoloca el carrito tras un añadido, los botones de checkout se desactivan un instante y `<html>` lleva la clase `ofd-cart-busy`. Las dos cosas se pueden desactivar en la configuración de la integración con el carrito: `orphanNotice: false` y `guardCheckoutWhileBusy: false`.

Todos llevan el mismo contexto:

```js
{
  version: 1,
  sessionId,            // aleatorio, por sesión del panel: cose una visita entera
  productId, variantId,
  stepIndex, stepId, stepType,
  totalSteps,           // pasos CONFIGURADOS, no los que recorrerá esta persona
}
```

`kind` vale `'throttled' | 'unavailable' | 'unknown'`: la causa, no el mensaje —el mensaje es una etiqueta que el comerciante puede reescribir—. Solo `throttled` merece reintento.

`completed` distingue «terminó» de «se fue», que es toda la diferencia para recuperar un abandono.

`totalPrice` va en **céntimos** y solo en `:addtocart:success`.

### Lo que estos eventos nunca llevan

**Dicen DÓNDE está el comprador, nunca QUÉ ha contestado.** Un `CustomEvent` lo lee cualquier script de la página, así que el `detail` es una lista cerrada: nunca contiene los valores de la graduación, el fichero subido ni su nombre, la foto de la receta, los textos del comerciante ni el nodo del paso.

Dos cosas que conviene saber antes de construir encima:

- **`stepType` es un dato de salud inferido.** Llegar al paso de graduación significa que esa persona tiene un defecto refractivo. Va incluido porque sin él los eventos no sirven para nada, y porque esa misma inferencia ya está al alcance de cualquier script de la página. Trátalo en consecuencia.
- **`totalPrice` solo después de añadir.** Una vez añadido, esa cifra está en `/cart.js` para quien quiera leerla. Antes de añadir sería información nueva, y en un formulario de lentillas revelaría un pedido de un solo ojo.

### Notifican, no dejan intervenir

Ninguno es cancelable: `preventDefault()` no hace nada. Es deliberado. Los tests A/B y las reglas de validación propias del comerciante necesitarán otro mecanismo, y se añadirá como tal en vez de cambiar lo que significan estos.

### Versionado

`version` sube solo si un campo existente **cambia de forma**. Añadir campos nuevos no la sube: quien lea lo que ya conocía sigue funcionando. Los eventos no se renombran ni se retiran sin un cambio de versión mayor.

### Actualizaciones de pantalla

`:step:rendered` se emite cuando el paso **cambia**, no cada vez que se actualiza la pantalla: adjuntar un fichero, el catálogo de lentillas estrechando una combinación o las opciones excluyentes redibujan el panel sin mover al comprador de sitio. Si necesitas enterarte de cuándo entra HTML nuevo —una capa de traducción, por ejemplo— usa un `MutationObserver` sobre el panel.

## Referencia completa

El detalle técnico (resolver, CartBridge, selectores, eventos) vive en `INTEGRATION.md`, dentro de la extensión de la app: `extensions/optical-form-ext/INTEGRATION.md`.

---

# Botón y carrito (ajustes del tema)

> Los ajustes del bloque y de la incrustación que se configuran en el editor de temas de Shopify.

Source: https://docs.getoptical.app/desarrolladores/boton-y-carrito/
Language: es

Además del panel de la app, Optical Form expone ajustes en el **editor de temas** de Shopify: un **bloque** para el botón y una **incrustación de la app** para el panel y el carrito.

## Bloque "Optical Form" (el botón)

Se añade a la sección del producto y controla el botón que abre el panel.

- **Contenido**: texto del botón (vacío = texto traducido por defecto) y, opcionalmente, un **icono** de tu biblioteca de Archivos, con su posición (antes o después del texto) y la separación respecto al texto.
- **Colores**: fondo, texto y borde, cada uno con su variante hover. Por defecto gris oscuro neutro.
- **Forma y tipografía** (comunes): radio, grosor de borde, grosor de letra, letter-spacing (px) y transformación.
- **Escritorio** y **Móvil** por separado: ajustar al contenido, anchura (%), padding vertical/horizontal y tamaño de letra. El corte está en 750px.

**El botón no hereda tokens**

Los colores del botón **no** caen a los `--ofd-*` del panel. Esos tokens se aplican sobre el panel (`_applyStyling` → `this.panel`) y el botón vive fuera, así que heredarían el `:root` del CSS de la app — es decir, el color de marca de Optical Form filtrándose a la tienda del cliente. Por eso los defaults del botón son neutros y explícitos.

- **Avanzado → `variant_input_selector`**: selector CSS para la variante seleccionada; solo si el tema no actualiza `[name="id"]` ni `?variant=`. Ver [Integración con el tema](https://docs.getoptical.app/desarrolladores/integracion/).

## Incrustación de la app "Optical Form Drawer"

Se activa en **Incrustaciones de aplicaciones** y controla el panel y su relación con el carrito del tema.

**Aspecto del carrito**

- **Compactar las líneas de complementos** (`cart_tidy_addons`) — desactivada por defecto. Encoge las líneas de los complementos para que la montura siga siendo la protagonista. Solo cambia tamaños: qué controles enseña cada línea lo deciden los tres ajustes siguientes. Verificada en Horizon 4.x y en Split; en temas que no imprimen esa clase no hace nada.
- **Complementos en el carrito** (`cart_addon_rows`) — **«Visibles sin controles»** por defecto desde octubre de 2026 (antes, «Visibles con sus controles»; si ya tenías la incrustación activada conservas tu elección): sin selector de cantidad ni papelera. «Ocultos» no muestra sus líneas en el carrito. Se cobran igual y salen en el checkout y en el pedido: la línea de la montura enseña el precio de la montura y el total del carrito los incluye, y lo que el cliente eligió sigue legible bajo la montura.
- **Ocultar el botón de eliminar de los accesorios** (`cart_accessory_remove`) — desactivada. Al borrar la montura se van igualmente.
- **Ocultar el selector de cantidad de las lentillas** (`cart_contact_lens_selector`) — activada por defecto desde octubre de 2026 (antes, desactivada). Las cajas por ojo se eligen en el configurador y la app devuelve la cantidad si algo la cambia en el carrito; esto solo esconde el selector.
- **CSS personalizado** — reglas para sobrescribir cualquier estilo del panel o del botón. Se carga en todas las páginas de la tienda, así que sirve también para reestilizar cómo muestra tu tema las propiedades de línea en el carrito.

**Integración con el carrito**

- **Tras añadir al carrito** (`cart_after_add`): abrir el panel del carrito del tema, redirigir a `/cart`, o no hacer nada. «No hacer nada» solo significa que la integración con el carrito no abre nada: el tema sigue recibiendo el evento estándar `shopify:cart:lines-update` (`action: 'add'`), y Horizon 4.x abre su panel del carrito con él si su `cart-drawer-component` lleva `auto-open` (su ajuste **«"Add to cart" auto-opens drawer»**, en Ajustes del tema › Cart; en Horizon 4.2.0 viene desactivado). Manda el tema. Desde la 1.5 las líneas del carrito viajan en la misma petición que el añadido y en la promesa del evento (`detail.sections`), así que Horizon las muestra antes de abrir.
- **Mantener el carrito sincronizado** (`cart_intercept`) — **activada por defecto**. En temas con los eventos estándar de carrito de Shopify escucha de forma pasiva; en temas antiguos monitoriza las llamadas a la API del carrito.
- **Cantidad del conjunto desde el carrito** (`cart_set_quantity`) — **«Escalar»** por defecto: si el cliente sube la cantidad de la montura en el carrito, los complementos se multiplican con ella (dos lentes por montura, un tratamiento por montura…). **«Bloquear»** la devuelve a 1 con un aviso corto bajo la línea. En los dos modos, un complemento cambiado por su cuenta vuelve a su sitio, y las **lentillas nunca se escalan**: sus cajas por ojo se fijan en el configurador y cualquier cambio vuelve a ellas con su propio aviso. Los textos de los dos avisos están traducidos y se pueden cambiar en los locales de la app.
- **Accesorios en el carrito** (`cart_accessory_quantity`) — **«Cantidad libre»** por defecto: líquidos, fundas y otros extras los cambia el cliente y no se multiplican con la montura. «Siguen a la montura» los trata como un complemento más.
- **Si se quita una lente o un tratamiento** (`cart_orphan_action`) — **«Quitar el conjunto entero»** por defecto: si el cliente quita desde el carrito una lente, un tratamiento o un color, la app quita la montura y el resto de sus complementos en una sola petición, con un aviso corto en el carrito (texto traducido, `cart_set_removed_notice` en los locales). Un accesorio quitado por su cuenta nunca lo provoca. «Conservar la montura y avisar» deja la montura marcada con el aviso bajo la línea, como antes, y no quita nada: la decisión es tuya, con el evento `optical-form:cart:orphan`.

**Los ajustes de controles nacen sin efecto**

Todo lo anterior viene por defecto como se veía hasta ahora: nada oculto, y los complementos siguiendo a la montura. Las reglas que ocultan controles alcanzan a los temas que hemos medido (Horizon 2.x a 4.x, Dawn 15 y 16, Split) y, en cualquier otro, a las marcas que la integración con el carrito deja en los controles de cada fila del conjunto. Ver [Temas probados](https://docs.getoptical.app/guias/temas-probados/#cualquier-tema-las-clases-que-deja-la-integración-con-el-carrito).

**Avanzado** — solo si tu tema no se detecta solo:

- **Abrir el panel desde el icono del carrito** (`cart_intercept_icon`) — **desactivada por defecto**. Actívala solo si al pulsar el icono no pasa nada.
- **Selectores CSS** (vacíos = autodetección): contador del carrito, icono del carrito e **IDs de secciones a refrescar**. No hay selector propio para el panel del carrito: se detecta solo.
- **Modo debug** — vuelca la actividad de CartBridge a la consola del navegador.

**Empieza con auto-detección**

Deja los selectores vacíos: CartBridge autodetecta los patrones de Dawn, Horizon y la mayoría de temas. Solo rellénalos si el carrito no se refresca o el panel no abre.

---

# Qué hacer con cada evento

> Los ocho eventos que emite el configurador, uno a uno, y qué puedes montar encima con tu chat, tu analítica o tu recuperación de carritos, sin tocar la app.

Source: https://docs.getoptical.app/desarrolladores/eventos/
Language: es

El configurador cuenta lo que hace el comprador mediante eventos del navegador. No hay que activar nada: se emiten siempre, y si nadie escucha no pasa nada. Esta página va evento por evento con ideas concretas; el contrato técnico (campos comunes, versionado, lo que nunca llevan) está en [Integración con el tema](https://docs.getoptical.app/desarrolladores/integracion/#eventos-del-configurador).

## Cómo escuchar

Se emiten sobre `<optical-form-drawer>` y **burbujean**, así que basta con escuchar en `document`. Todos llevan `detail` con el mismo contexto: `sessionId` (cose una visita entera), `productId`, `variantId`, `stepIndex`, `stepId`, `stepType` y `totalSteps`.

```js
document.addEventListener('opticalform:open', (e) => {
  console.log('configurador abierto en el producto', e.detail.productId);
});
```

Dos límites que conviene tener claros antes de construir: los eventos **no llevan las respuestas** del comprador (ni graduación, ni fichero, ni textos) y **no se pueden cancelar**. Dicen dónde está, no qué ha contestado, y no dejan intervenir.

## Los diez eventos

### `opticalform:open` — se abre el configurador

Es el primer momento en que sabes que esa persona quiere montar unas gafas, no solo mirar la montura.

- **Cargar el chat solo ahora.** Si tu chat se carga en diferido por privacidad, este evento es el buen momento: quien mira sin tocar no deja cookies de terceros.
- **Marcar la sesión** en el chat o en la analítica: «está configurando gafas» vale más que «vio un producto».
- **Arrancar un reloj**: el tiempo desde aquí hasta `:addtocart:success` es tu tiempo de configuración real.

```js
document.addEventListener('opticalform:open', () => {
  if (!window.miChatCargado) cargarMiChat(); // tu función, tu proveedor
});
```

### `opticalform:step:rendered` — el comprador llega a un paso

Trae además `isFirst` e `isLast`. Se emite cuando el paso **cambia**, no cada vez que se actualiza la pantalla.

- **Embudo por paso** en tu analítica: sabrás en qué paso se queda la gente, que es la pregunta que decide qué arreglar.
- **Mensaje contextual** del chat al llegar a la graduación (`stepType` `graduation`, `reading_rx` o `contact_lens`): «¿tienes tu receta a mano? Si no, sube una foto». Una vez por sesión, no en cada paso.
- **Preparar el final** cuando `isLast` es `true`: por ejemplo, avisar de que el envío es gratis.

```js
document.addEventListener('opticalform:step:rendered', (e) => {
  dataLayer.push({ event: 'lens_step', step: e.detail.stepType, index: e.detail.stepIndex });
});
```

### `opticalform:validation:error` — un paso no le deja avanzar

No lleva el valor que falló, solo el paso.

- **Contar en qué paso tropieza** la gente. Si un paso concentra los errores, el problema es el paso: su texto de ayuda, su ejemplo, su obligatoriedad.
- **Ofrecer ayuda tras varios intentos**: al segundo o tercer error en el mismo paso, el chat puede abrirse con una pregunta directa.

### `opticalform:addtocart:start` — empieza el añadido

Entre este evento y el siguiente el configurador está hablando con el carrito de Shopify.

- **Esconder lo que estorbe** durante el añadido, por ejemplo un lanzador de chat que flota sobre el botón.
- **Medir la latencia** hasta `:addtocart:success`: si sube, algo ha cambiado en el tema o en una app del carrito.

### `opticalform:addtocart:success` — el carrito lo aceptó

Trae `lineCount`, `totalPrice` (en céntimos) y `currency`. Es tu evento de conversión.

- **Enviar la conversión** a GA4, Meta o TikTok con su valor. Antes de este momento el precio no viaja a propósito; después ya está en `/cart.js`.
- **Recomendar el complemento** que no eligió: un estuche, un segundo par, un tratamiento.
- **Explicar el carrito** a quien lo ve por primera vez: la montura y cada lente o tratamiento llegan como líneas separadas, con su precio. Es lo que recibe tu laboratorio.

```js
document.addEventListener('opticalform:addtocart:success', (e) => {
  gtag('event', 'add_to_cart', {
    value: e.detail.totalPrice / 100,
    currency: e.detail.currency,
    items: [{ item_id: String(e.detail.productId), quantity: e.detail.lineCount }],
  });
});
```

### `opticalform:addtocart:error` — falló

Trae `kind` — la causa — y `line` — qué línea falló. `kind` es uno de `sold_out` (la montura está agotada), `addon_unavailable` (un tratamiento, color o accesorio no se puede vender), `limit` (el carrito ya tiene todo el stock), `unavailable` (algo ya no existe), `throttled` (Shopify pidió esperar) o `unknown`; `line` es `frame`, `addon` o `unknown`. Sale también cuando el panel se niega a enviar sin llamar a Shopify, porque ya sabía que la montura o un complemento estaban agotados.

- **Avisar a soporte** con `sessionId`, `productId`, `kind` y `line`: llegas antes de que el comprador escriba.
- **Reintentar solo si es `throttled`**; los demás no se arreglan repitiendo.
- **Vigilar `addon_unavailable`**: cada uno es una variante de lente, color o accesorio que no se puede vender mientras la gente la elegía — el editor te lo enseña con **Comprobar precios**. `sold_out` es la montura: el botón de la página de producto ya debería decir «Agotado».

### `opticalform:close` — se cierra

Trae `completed`: `true` si terminó, `false` si se fue. Es toda la diferencia para recuperar un abandono.

- **Abandono con contexto**: con `completed` a `false` sabes en qué paso estaba (`stepType`, `stepIndex`) y en qué producto. Un mensaje del chat, un aviso de «te guardamos la configuración» o un formulario de correo valen más aquí que en cualquier popup de salida.
- **No molestar a quien terminó**: con `completed` a `true` lo único que toca es dejarle ir al carrito.

```js
document.addEventListener('opticalform:close', (e) => {
  if (!e.detail.completed) miChat.mensaje('¿Te has quedado con dudas? Escríbenos aquí.');
});
```

### `opticalform:resume` — el comprador retoma una configuración a medias

Si cerró el configurador sin terminar y vuelve al mismo producto en 7 días, la app le ofrece «Continuar donde lo dejaste». Este evento sale cuando lo pulsa. Trae `restoredSteps`: cuántos pasos han recuperado su respuesta. Como todos, **no dice qué respondió**. Y solo sale si el comerciante ha activado «Recordar la configuración a medias» en Diseño › Navegación (viene desactivado por defecto).

- **Medir si sirve**: cuántos `resume` frente a cuántos `close` sin `completed` dice si vale la pena mantenerlo activado. La pestaña Analítica ya te lo cuenta («N retomaron una configuración a medias»).
- **Cambiar el tono del chat**: quien retoma ya decidió la mitad; un «¿te ayudo con la graduación?» encaja mejor que un «¿empezamos?».

```js
document.addEventListener('opticalform:resume', (e) => {
  miAnalitica.evento('configurador_retomado', { pasos: e.detail.restoredSteps });
});
```

### `optical-form:cart:orphan` — en el carrito falta una línea del conjunto

Este no lo emite el configurador sino la integración con el carrito, en `document`, cuando detecta una montura sin las lentes, tratamientos o colores con los que salió: el cliente los borró desde el carrito del tema (un accesorio borrado no cuenta). Trae `groupId`, `key`, `expected`, `actual` y `action`: `'removed'` cuando la app ha quitado el conjunto entero —lo que hace por defecto desde octubre de 2026; lleva además `lines`, las claves de las líneas que puso a 0— o `'notice'` cuando elegiste «Conservar la montura y avisar» en la incrustación: entonces la app muestra un aviso traducido bajo la fila y **no borra nada ni bloquea el checkout**.

- **Decidir tú** (con «Conservar la montura y avisar»): quitar la montura, avisar por chat, o dejarlo pasar si en tu tienda una montura se puede comprar sola.
- **Medirlo**: cuántos borran las lentes dice si el precio del complemento sorprende en el carrito.

### `optical-form:cart:resync` — la integración con el carrito ha cuadrado un conjunto

También de la integración con el carrito, en `document`, cada vez que corrige las cantidades de un conjunto tras un cambio del cliente en el carrito del tema: la montura subió y los complementos se han multiplicado con ella («Escalar»), o la montura ha vuelto a su base («Bloquear», o una lentilla). Trae `groupId`, `mainKey`, `quantity` (la cantidad de la montura tras el ajuste), `base`, `sets`, `mode` (`'scale'` o `'lock'`) y `changed` (una lista de `{ key, from, to }` con cada línea tocada). Puede llevar `reason`: `'form-quantity'` cuando lo que ha vuelto es una lentilla a sus cajas, `'unknown-ratio'` cuando la integración con el carrito no sabe la proporción del conjunto y no toca nada, y `'capped'` cuando Shopify no aceptó la cantidad pedida (sin stock) y el conjunto queda marcado con `ofd-bundle-mismatch`.

- **Enseñar el ajuste a tu manera**: la app muestra un aviso traducido bajo la línea; con este evento puedes sustituirlo por el tuyo.
- **Medirlo**: cuántos suben la montura desde el carrito, y cuántas veces Shopify recorta por stock.

## Tres recetas completas

**Embudo en Google Analytics 4.** Escucha `:open`, `:step:rendered`, `:validation:error`, `:addtocart:success` y `:close`, y manda cada uno como evento con `stepType` e `stepIndex`. En GA4, un informe de embudo por `stepIndex` te enseña la caída paso a paso; `sessionId` como dimensión personalizada une la visita entera.

**Chat que acompaña.** Carga tu proveedor en `:open`, guarda en `sessionStorage` qué mensajes ya has enseñado para no repetirlos, y lanza como mucho uno por hito: llegar a la graduación, añadir al carrito, cerrar sin terminar. Si tu chat vive abajo a la derecha, dale sitio con el ajuste **Espacio libre a la derecha del pie** (Diseño › Navegación) para que no tape el botón de continuar: ver [Diseño y carrito](https://docs.getoptical.app/guias/diseno-y-carrito/).

**Recuperación de abandono.** En `:close` con `completed` a `false`, guarda `productId` y `stepIndex`; si tienes el correo del cliente (porque ha iniciado sesión o lo pide tu popup), tu herramienta de correo puede enviarle un «sigue donde lo dejaste» con el enlace al producto. La app no guarda la configuración a medias: lo que recuperas es la intención, no las respuestas.

## Lo que no puedes hacer con ellos

- Cancelar un paso, un añadido o un cierre: `preventDefault()` no hace nada, a propósito.
- Leer la graduación, el fichero subido o los textos del comerciante: el `detail` es una lista cerrada. `stepType` sí viaja, y es un dato de salud inferido; trátalo como tal.
- Cambiar lo que valida un paso: eso se configura en el formulario, no en un script.

Los detalles de versionado y de actualizaciones de pantalla están en [Integración con el tema](https://docs.getoptical.app/desarrolladores/integracion/#versionado).

---

# Agencias y tiendas de desarrollo

> Si montas la tienda de una óptica para un cliente — Pro gratis en tu tienda de desarrollo, qué pasa al pasar a la tienda real y qué necesitamos de tu tema.

Source: https://docs.getoptical.app/desarrolladores/tiendas-de-desarrollo/
Language: es

Si eres una agencia o un desarrollador y estás montando la tienda de una óptica para un cliente, lo normal es empezar en una **tienda de desarrollo** de Shopify Partners. Optical Form está pensada para ese recorrido. Esto es lo que cambia respecto a una tienda normal, y lo que no.

## Pro no cuesta nada en una tienda de desarrollo

Shopify permite a los desarrolladores probar apps en sus tiendas de desarrollo **sin pagar la suscripción**, y Optical Form tiene esa opción activada. Al pulsar **Ver planes y precios** dentro de la app, la página de Shopify te ofrece **Pro a $0**: lo apruebas y tienes una suscripción real, sin cargo y sin fecha de caducidad mientras la tienda siga siendo de desarrollo.

No hay reloj de prueba que vigilar ni tarjeta que meter. Es la misma app, con todo lo que hace Pro.

## Los 14 días de bienvenida también cuentan aquí

Como en cualquier tienda, al instalar tienes [14 días de bienvenida](https://docs.getoptical.app/facturacion/planes/#qué-pasa-desde-que-instalas) con la app completa sin elegir plan. En una tienda de desarrollo eso tiene una consecuencia práctica: si no eliges el Pro gratuito, **el día 14 los configuradores se desactivan igual**, en mitad de tu trabajo. Elígelo el primer día y olvídate del calendario.

## Al pasar a la tienda del cliente

La tienda de desarrollo y la tienda real son dos tiendas distintas para Shopify, así que la app se instala **de nuevo** en la del cliente, desde el [App Store](https://apps.shopify.com/optical-form). Ahí sí se elige plan y se aprueba el cargo: los **14 días de prueba** empiezan ese día, no el día que instalaste en la tienda de desarrollo. Tu cliente puede cancelar antes de que terminen sin pagar nada.

Para llevarte el trabajo hecho, **exporta cada formulario como JSON** desde su pestaña Ajustes e impórtalo en la tienda real. Un detalle: los complementos y accesorios apuntan a productos de la tienda donde se crearon, así que al importar revisa esas vinculaciones y vuelve a apuntarlas a los productos del cliente. Ver [Copiar un formulario](https://docs.getoptical.app/guias/copiar-formulario/).

Los ajustes del tema —la incrustación de la app y el bloque del botón— tampoco viajan: se activan otra vez en el tema del cliente. La Guía de configuración del Home lo detecta y te lo señala.

## Qué puedes probar en una tienda de desarrollo

Todo el recorrido del comprador, incluido el checkout: las tiendas de desarrollo aceptan **pedidos de prueba** con la pasarela de pruebas de Shopify, así que puedes ver cómo llega la graduación al pedido y al correo de confirmación antes de que exista un cliente real. Lo único que no puedes hacer es cobrar de verdad.

## Tu tema

Optical Form funciona en cualquier tema con Online Store 2.0, pero **el carrito lo muestra el tema**, y ahí está la diferencia entre uno y otro. Mira primero [Temas probados](https://docs.getoptical.app/guias/temas-probados/): si el del cliente está, ahí tienes qué ajustar y el CSS ya medido.

Si no está, mándanos a [support@getoptical.app](mailto:support@getoptical.app) **un enlace de vista previa del tema con el formulario activo en una página de producto**. Con eso medimos cómo muestra el carrito ese tema y te devolvemos la receta — qué tocar en los ajustes de la incrustación y qué CSS pegar — antes de que salga a producción. Es lo que hacemos con cada tema nuevo, y prefiere hacerlo antes que después.

## Si algo no encaja

Escríbenos. Una agencia que monta ópticas nos interesa mucho más que una instalación suelta, y respondemos rápido a las preguntas de integración.

---

# Preguntas frecuentes

> Dudas comunes sobre Optical Form.

Source: https://docs.getoptical.app/faq/
Language: es

## ¿Cobráis comisión sobre mis ventas?

No. Nunca. GetOptical cobra un **precio de plan fijo** —mensual o anual— y te quedas el 100% de cada venta.

## ¿Puede un cliente comprar sin rellenar el formulario?

Sí, si tú lo permites — y eso es una decisión de negocio tuya, no un fallo de la app. Tu tema mantiene sus propios botones de compra (el de la página de producto, la barra que aparece al bajar y la compra rápida de los listados), y esos añaden la montura **sin lentes ni graduación**.

Puede ser exactamente lo que quieres, si también vendes monturas sueltas. Y si no lo es, se cierra en diez minutos con una plantilla de producto propia. Las dos vías, con sus pasos, en [Controlar cómo se compra cada montura](https://docs.getoptical.app/guias/evitar-compras-sin-configurar/).

## ¿Funciona en mi tema?

Sí, en cualquier tema con **Online Store 2.0** — los que permiten añadir bloques desde el editor de temas. Optical Form usa una capa agnóstica al tema que detecta la variante seleccionada y agrupa el carrito correctamente: verificada en **Dawn** y **Horizon**, y con adaptadores para temas a medida. Ver [Integración con el tema](https://docs.getoptical.app/desarrolladores/integracion/).

## ¿Qué pasa si el cliente pulsa «Atrás» en el navegador?

Retrocede un paso, igual que el botón «Anterior» del panel: abrir el configurador y cada paso adelante dejan una entrada en el historial del navegador, así que el gesto de volver del móvil hace lo que el cliente espera. En el primer paso, «Atrás» cierra el configurador y el cliente sigue en la página del producto — nunca se lo lleva a otra página. Al cerrar, esas entradas desaparecen y el historial queda como estaba.

## ¿Necesito un desarrollador para instalarla?

No. Se instala activando una **incrustación de la app** y asignando el formulario a un producto. Solo temas muy personalizados pueden necesitar ajustar un selector CSS. Ver [Instalar](https://docs.getoptical.app/empezar/instalacion/).

## ¿Cómo se facturan los tipos de lente y tratamientos?

Como **productos reales de Shopify** vinculados a las opciones ([complementos](https://docs.getoptical.app/guias/accesorios-y-addons/)). Se añaden como líneas separadas y se agrupan bajo el producto principal como un bundle, así que Shopify los incluye en el pedido y llegan a tu laboratorio.

## ¿Puede el cliente elegir el color de un tinte o de una polarizada?

Sí. En cualquier opción del formulario puedes añadir una fila de **colores seleccionables**: el cliente toca el color que quiere y **solo ese se cobra** y llega al pedido con su referencia. Cada color es una variante de un producto tuyo en Shopify, y la muestra de color es la foto de esa variante — no hay que configurar nada más. Si quieres agrupar los colores (clásicos, de moda, degradados…), crea un producto por grupo. Ver [Colores seleccionables](https://docs.getoptical.app/guias/accesorios-y-addons/#colores-seleccionables-por-opción).

## Cambié un formulario y no se actualiza en la tienda. ¿Por qué?

Guardar no publica. Tienes que pulsar **Sincronizar** para que los cambios lleguen a la tienda, y el formulario debe estar **Activo**. Ver [Sincronización](https://docs.getoptical.app/guias/sincronizacion/).

## ¿Puede un producto tener dos formularios?

No. **Cada producto admite un solo formulario**, aunque un formulario pueda llevar muchos productos.

Si asignas a un formulario un producto que ya estaba en otro, **se lo lleva el nuevo**, sin avisarte: el anterior lo pierde en silencio. Si lo que quieres es que la misma montura se venda **con y sin** configurador, no hacen falta dos formularios ni dos productos: el botón de tu tema y el de Optical Form conviven en la misma página de producto (ver [Controlar cómo se compra cada montura](https://docs.getoptical.app/guias/evitar-compras-sin-configurar/)). Dos **formularios** distintos sobre la misma montura sí exigen dos productos. Ver [Crear un formulario](https://docs.getoptical.app/guias/crear-formulario/).

Con las colecciones la regla es la misma pero por capas: la asignación directa del producto gana siempre, y si solo llega por colección, muestra el formulario de la primera colección asignada en la que esté. Ver [Productos y colecciones](https://docs.getoptical.app/guias/productos-y-colecciones/).

## ¿Puedo copiar un formulario a otra tienda?

Sí. **Exporta el formulario como JSON** desde la pestaña Ajustes y usa **Importar desde JSON** en la otra tienda.

## ¿Hay prueba gratis?

Sí — **14 días**, facturados por Shopify. Cancela antes de que terminen y no se te cobra.

Un detalle que decide cuándo suscribirse: **la prueba empieza cuando apruebas la suscripción, no cuando instalas la app**. Los días que tardes en decidirte no te los gasta nadie.

Y antes de la prueba hay otra cosa: **14 días de bienvenida desde que instalas**, con la app completa y sin elegir plan. Al acabarse, los configuradores se desactivan en la tienda hasta que elijas plan — pero no se borra nada. La cronología entera, día a día, en [Planes y facturación](https://docs.getoptical.app/facturacion/planes/#qué-pasa-desde-que-instalas).

## Soy una agencia y trabajo en una tienda de desarrollo, ¿pago?

No. En una tienda de desarrollo de Shopify Partners puedes elegir **Pro a $0** y montar la tienda del cliente sin reloj. La suscripción de verdad se elige cuando la app se instala en la tienda real, y la prueba de 14 días empieza ese día. Ver [Agencias y tiendas de desarrollo](https://docs.getoptical.app/desarrolladores/tiendas-de-desarrollo/).

## ¿Vendéis lentillas?

Sí, y están incluidas en **Pro**: no hay que esperar a ningún plan futuro. Al instalar ya tienes un formulario de **Lentillas** de ejemplo, en borrador, y **Crear formulario** trae esa plantilla.

El cliente elige el pack, marca los ojos que pide y su graduación por ojo. Si tu producto trae el catálogo de combinaciones que el fabricante produce de verdad, la app resuelve la referencia exacta y la manda en el pedido, para que tu laboratorio pida sin traducir nada.

## ¿Funciona con apps de suscripción?

Sí. Si el cliente elige un plan en la página de producto —con Shopify Subscriptions, Appstle o cualquier app que ponga su selector ahí— antes de abrir el configurador, ese plan viaja con la montura o las lentillas: el panel enseña el precio del plan y el carrito cobra ese mismo importe. Los complementos y accesorios se añaden como compra única. Sin plan elegido, todo funciona como siempre. Detalle para desarrolladores en [Integración con el tema](https://docs.getoptical.app/desarrolladores/integracion/#plan-de-suscripción-apps-de-suscripciones).

## ¿Puede el cliente pedir dos monturas iguales?

Sí, desde el carrito: sube la cantidad de la montura con el selector de tu tema y las lentes y los tratamientos se multiplican con ella. Si cambia un complemento por su cuenta, vuelve a su sitio. Y si prefieres que cada montura configurada sea siempre una unidad, en la incrustación de la app pon **Cantidad del conjunto desde el carrito** en «Bloquear»: vuelve a 1 con un aviso. Con las lentillas no hay caso: sus cajas por ojo se eligen en el configurador, y cualquier cambio en el carrito vuelve a ellas. Ver [Temas probados](https://docs.getoptical.app/guias/temas-probados/#cambiar-la-cantidad-desde-el-carrito).

## ¿Cómo se tratan los datos de graduación?

**No pasan por nuestros servidores.** La graduación y el archivo que suba tu cliente viajan por TLS **directamente al pedido de Shopify** de tu tienda, como propiedades de línea. Nosotros no los almacenamos ni podríamos leerlos: la app no pide permiso para leer pedidos ni clientes.

Eso significa que el responsable de esos datos eres tú, y que las peticiones de acceso o borrado se resuelven dentro de tu Shopify. Puedes ocultarlos de lo que ve el cliente sin perderlos del pedido — ver [Diseño y carrito](https://docs.getoptical.app/guias/diseno-y-carrito/) — y el detalle legal está en la [Política de Privacidad](https://www.getoptical.app/privacy).

## ¿Qué pasa con mis datos si desinstalo la app?

Tus **formularios y sus asignaciones se conservan**: si reinstalas, vuelven tal cual y se publican de nuevo. La copia de tu catálogo y la analítica del configurador **se borran a los 30 días** — la app las vuelve a leer de Shopify cuando hace falta. Las recetas de tus clientes nunca han estado con nosotros: viajan dentro de tus pedidos de Shopify. Al desinstalar te llega un único correo que dice exactamente esto; si prefieres que lo borremos todo en el momento, responde a ese correo.

## ¿Me vais a mandar correos?

Solo si te hace falta, y siempre a la dirección de tu tienda en Shopify — nunca a tus clientes.

Son dos cosas: unos pocos avisos de puesta en marcha si te quedas atascado en un paso (como máximo **tres**, y ninguno si terminas la configuración), y los avisos de cobro si tu suscripción deja de estar activa. No hay boletín, ni ofertas, ni cadencia semanal.

Para dejar de recibirlos, **responde a cualquiera de ellos**: llega a una persona y los desactivamos. También puedes escribir a [support@getoptical.app](mailto:support@getoptical.app).

---

# GetOptical Documentation

> Sell prescription eyewear and lenses on Shopify — 0% commission, on any theme.

Source: https://docs.getoptical.app/en/
Language: en

### Get started

Read **Before you start** first: four decisions and a product list that save you redoing the work. Then enable the app embed, create your form and assign it to a product.
[Before you start](https://docs.getoptical.app/en/empezar/antes-de-empezar/) · [Install guide](https://docs.getoptical.app/en/empezar/instalacion/) · [Key concepts](https://docs.getoptical.app/en/empezar/conceptos/)

### Build a form

The 10 step types, the anatomy of an option and branching by answer. Which products show it, what happens with a frame without lenses, and how a form is published, backed up and moved to another store.
[Build a form](https://docs.getoptical.app/en/guias/crear-formulario/) · [Products and collections](https://docs.getoptical.app/en/guias/productos-y-colecciones/) · [How each frame is bought](https://docs.getoptical.app/en/guias/evitar-compras-sin-configurar/) · [Sync & backups](https://docs.getoptical.app/en/guias/sincronizacion/) · [Copy to another store](https://docs.getoptical.app/en/guias/copiar-formulario/)

### Prescription capture

Capture SPH, CYL, AX, ADD and PD per eye, or a reading grid; or let the customer upload the prescription as an image or PDF. Contact lens steps are there too, included in Pro.
[Prescription](https://docs.getoptical.app/en/guias/graduacion/) · [File upload](https://docs.getoptical.app/en/guias/subir-receta/)

### Add-ons, pricing & icons

Sell lenses, treatments and cross-sell billed as separate lines; where every cent of the total comes from; and a pack of 28 icons for your options.
[Add-ons & accessories](https://docs.getoptical.app/en/guias/accesorios-y-addons/) · [Pricing and charging](https://docs.getoptical.app/en/guias/precios-y-cobro/) · [Icons](https://docs.getoptical.app/en/guias/iconos/)

### Design, theme & cart

Colors, typography, behavior and what data shows in the cart; the product button; the settings that live in your theme and the themes we have tested; and where every text your customer sees comes from.
[Design & cart](https://docs.getoptical.app/en/guias/diseno-y-carrito/) · [The product button](https://docs.getoptical.app/en/guias/boton-del-producto/) · [Theme settings](https://docs.getoptical.app/en/guias/ajustes-del-tema/) · [Tested themes](https://docs.getoptical.app/en/guias/temas-probados/) · [Languages & wording](https://docs.getoptical.app/en/guias/traducciones/)

### Plans & billing

14-day welcome, 14-day free trial, 0% commission, and what changes when you pick a plan.
[Plans & billing](https://docs.getoptical.app/en/facturacion/planes/)

### When something isn't working

Find your symptom, follow the checks in order and stop at the first one that fails. What each Analytics figure means and what to change in the step that loses customers. Plus the most common questions, answered.
[When something isn't working](https://docs.getoptical.app/en/guias/cuando-algo-no-funciona/) · [Reading the analytics](https://docs.getoptical.app/en/guias/analitica/) · [FAQ](https://docs.getoptical.app/en/faq/)

### For developers

Theme-agnostic install, hooks and cart grouping; and if you build an optician's store for a client, Pro is free on your development store.
[Integration](https://docs.getoptical.app/en/desarrolladores/integracion/) · [What to do with each event](https://docs.getoptical.app/en/desarrolladores/eventos/) · [Button & cart](https://docs.getoptical.app/en/desarrolladores/boton-y-carrito/) · [Agencies and development stores](https://docs.getoptical.app/en/desarrolladores/tiendas-de-desarrollo/)

---

# Before you start

> Four decisions and a product list worth settling before you touch the app. Half an hour here saves you redoing the work.

Source: https://docs.getoptical.app/en/empezar/antes-de-empezar/
Language: en

You can install the app and start building. But there are four things that, decided up front, stop you having to redo forms and products halfway through.

None of this happens inside Optical Form: it's preparation in your own store.

## 1. Which frames sell with a form

Usually not all of them.

| Sold **with** a form | Sold **normally** |
|---|---|
| Prescription frames | Non-prescription sunglasses |
| Made-to-order readers | Cases, cleaning fluid, cloths |
| Replacement lenses | Accessories and gifts |

This list decides two later things: which products you assign the form to, and which product template they use. Write it down before you start.

**The mixed case**

Same frame sold with and without prescription? **No need to duplicate it.** A single product can carry both buttons: your theme's, which adds the bare frame, and Optical Form's, which opens the configurator. That's a business decision of yours, not a limit of the app — just give each button a name that says what it does. Create two products only when you want different prices, photos or copy for each version. Both routes, step by step, in [Controlling how each frame is bought](https://docs.getoptical.app/en/guias/evitar-compras-sin-configurar/).

## 2. The products behind your extras

This is the bulk of the prep work, and what most people skip.

Anything you want to **charge separately** — the lens type, a treatment, fitting — has to exist as a **Shopify product**. They aren't labels inside the app: they're real products, because it's Shopify that bills them, puts them on the order and sends them to your lab.

Prepare a list like this one:

```
Single vision standard 1.50 ......  0.00   (included in the frame price)
Single vision thin 1.60 .........  15.00
Single vision ultra-thin 1.74 ...  50.00
Premium anti-reflective .........  30.00
Blue light filter ...............  17.00
Photochromic ....................  40.00
Fitting .........................  12.00
```

Two things you'll decide with that list in hand, explained in [Pricing and charging](https://docs.getoptical.app/en/guias/precios-y-cobro/):

- **The price is the surcharge, not the total.** The frame already has its own.
- **Anything included still gets created, at 0.** That way the customer sees "Included" instead of a blank.

**Create them with the «Unlisted» status**

These products aren't for browsing: nobody should stumble on "Premium anti-reflective" in your glasses collection. Shopify has a product status made for exactly this: **Unlisted** (on the product page, next to Active and Draft). An unlisted product **doesn't show in collections, storefront search, recommendations, Google or the sitemap**, but it **can be added to the cart and bought** as usual: in the cart, checkout and order it behaves like an active product.

Don't leave them **unpublished** from the Online Store channel, or in Draft: a product that isn't published to the channel **can't be added to the cart**, and Shopify would reject the whole add — your customer would lose the frame too. Active but tucked in a collection you never link to also works, but it still shows up in search.

### How to put a product on the Online Store channel

If a product already exists and is missing from the channel, add it from its product page:

1. In your Shopify admin, go to **Products** and click the product's name.
2. In the **Publishing** section, click the icon next to the title.
3. In the dialog, tick **Online Store** and click **Done**.
4. Click **Save**.

Repeat for each product behind your extras. If you don't want it to show in collections or search, set its status to **Unlisted** on that same page.

## 3. How you'll assign the form

Two ways, and it's worth choosing up front:

| | When to use it |
|---|---|
| **By product** | Few frames, or each with its own form |
| **By collection** | Large catalog sharing one form |

Collections have an advantage that usually decides it: **they're live**. Add a new frame to the collection and it shows the form immediately, without going back into the app. If your catalog is going to grow, start there.

Create that collection now if it doesn't exist — for example *Prescription glasses*.

## 4. Decide how each frame gets bought

Your theme keeps **its own buy buttons**, so by default a customer can walk off with the frame and no lenses. That may suit you — some opticians sell bare frames on purpose — or it may be the last thing you want. It is your call, and it is worth making now rather than once people are already coming through.

Both routes, step by step: **[Controlling how each frame is bought](https://docs.getoptical.app/en/guias/evitar-compras-sin-configurar/)**.

If you are still choosing a theme and already know you want to close direct buying, bear in mind you will need to be able to **remove the buy buttons block** and **turn off the sticky bar** on a dedicated product template. Nearly every modern theme allows it.

## Checklist

Before building your first form:

- [ ] I know which products sell with a form and which don't
- [ ] My extras exist as products, priced as a **surcharge**
- [ ] Anything included exists at **0**
- [ ] They're **Unlisted** (not Draft, not unpublished)
- [ ] The prescription frames collection exists (if I'm going by collection)
- [ ] I have decided whether my frames can be bought unconfigured, and applied that decision

With that done, building the form takes half an hour. Without it, it takes half an hour and three trips back.

## Next step

[Install Optical Form](https://docs.getoptical.app/en/empezar/instalacion/) and then [Build a form](https://docs.getoptical.app/en/guias/crear-formulario/).

---

# Install Optical Form

> Install the app, enable the app embed and get your first form live on Shopify.

Source: https://docs.getoptical.app/en/empezar/instalacion/
Language: en

Optical Form installs through a theme **app embed** — no code required. The app includes a **Setup guide** that walks you through these steps.

## 1. Install the app

Install **[Optical Form from the Shopify App Store](https://apps.shopify.com/optical-form?locale=en)**. On first open, the setup guide appears on the Home.

**You don't need to pick a plan to get started**

From the moment you install you have a **14-day welcome window** with the full app: you can do every step in this guide and publish to your storefront without approving any charge. The **14-day free trial** is a separate thing and starts when you pick a plan. The full timeline is in [Plans & billing](https://docs.getoptical.app/en/facturacion/planes/#what-happens-from-the-moment-you-install).

## 2. Enable the app embed

1. In your Shopify admin: **Online Store → Themes → Customize**.
2. Open **App embeds** in the left panel.
3. Turn on **Optical Form Drawer** and click **Save**.

**Shortcut**

The **Activate the app** card on the Home opens the theme editor straight to the embed. It shows **Published** once the drawer is active on your live theme.

## 3. Add the block to your product page

This is the step that makes the button appear, and it's different from the previous one:

| | What it does | Where it goes |
|---|---|---|
| **App embed** (step 2) | Loads the form engine | Whole store, once |
| **"Optical Form" block** (this step) | **Draws the button** | Inside the product template |

Enable only the embed and the form exists, but **the product page shows nothing**.

1. In the theme editor, switch the view at the top to **Product** (the product template).
2. In the main section, click **Add block** → pick **Optical Form**.
3. Place it where you want it (usually next to the add-to-cart button) and click **Save**.

**Shortcut**

The *"Add the block to your product page"* step in the Setup guide opens the editor already on the product template with the block ready to drop in.

**Mind the published theme**

The guide checks your **published theme**. If you add the block to a draft theme, the step stays unchecked until you publish it.

## 4. You already have four sample forms

You don't start from nothing. On install, the app leaves **four draft forms** built and in your store's language:

- **Prescription glasses, full screen** — with sample treatment colours.
- **Prescription glasses** in a side panel — with branches for single vision, progressive, reading and non-prescription.
- **Sunglasses** in dark mode.
- **Contact lenses** — lens pack, prescription per eye, and care solutions.

They're **drafts**, so they don't appear on any product page until you activate them. Open them, walk through them, and keep whichever matches what you sell — it's almost always faster than starting blank.

If you'd rather start from something else, **Create form** offers five templates. See [Build a form](https://docs.getoptical.app/en/guias/crear-formulario/).

## 5. Create the add-on products

Lens types, treatments and services are billed as **real Shopify products**. Create them with the **Unlisted** status — purchasable but absent from collections and search, see [Before you start](https://docs.getoptical.app/en/empezar/antes-de-empezar/#2-the-products-behind-your-extras)— and link them to options as [add-ons](https://docs.getoptical.app/en/guias/accesorios-y-addons/).

## 6. Assign the form to products

On the form's **Products** tab, choose which products it appears on. On those pages the customer sees the **"Configure your lenses"** button and follows the multi-step flow.

You can pick individual products or **whole collections**: with a collection, every product in it — including those that join later — shows the form, no matter how many there are. The rules are in [Products and collections](https://docs.getoptical.app/en/guias/productos-y-colecciones/).

## 7. Activate and sync

Set the form to **Active** and click **Sync** to publish it to Shopify. A form only appears on the store if it's **Active + Synced**. See [Sync](https://docs.getoptical.app/en/guias/sincronizacion/).

## 8. Decide how each frame gets bought

One decision left, and it is a business one: your theme keeps **its own buy buttons**, so as things stand a customer can walk off with the frame and **no lenses**. If you also sell bare frames, that is exactly what you want. If you don't, that order arrives paid and with no prescription, and you find out in the lab.

Make it now rather than later: [Controlling how each frame is bought](https://docs.getoptical.app/en/guias/evitar-compras-sin-configurar/).

## Next step

Review the [Key concepts](https://docs.getoptical.app/en/empezar/conceptos/) or jump straight to [Build a form](https://docs.getoptical.app/en/guias/crear-formulario/).

Something not behaving? [When something isn't working](https://docs.getoptical.app/en/guias/cuando-algo-no-funciona/).

---

# Key concepts

> The Optical Form vocabulary — form, step, option, add-on, accessory and bundle.

Source: https://docs.getoptical.app/en/empezar/conceptos/
Language: en

Before you build, it helps to know the pieces Optical Form uses. They all appear under these names in the app admin.

## Form

A **multi-step flow** the customer completes on the product page. It has a **name**, a **status** (Draft / Active / Archived) and a list of **steps**. It's assigned to one or more products and published to Shopify via sync.

## Step

Each **step** asks the customer a question (lens type, material, prescription, accessories…). It has an **Input type** that decides how it renders. See [Build a form](https://docs.getoptical.app/en/guias/crear-formulario/) for the full list.

## Option

Inside a select step, each **option** is a selectable card (e.g. "Progressive", "Anti-reflective"). An option can carry: a **label**, an **image**, an informational **badge** (visual only), incompatibilities with other options, a **jump** to another step, and one or more **add-ons**.

## Add-on

A **Shopify product linked to an option** that's billed as a **separate line item** in the cart when the customer picks that option (e.g. the lens type itself, a treatment, a fitting service). They're grouped under the main product as a bundle.

## Selectable colours

A **row of colour swatches** inside an option (tints, polarised, photochromic). The customer picks one colour and **only that one** is charged: each colour is a variant of one of your products, and several products form titled groups (Classic, Fashion, Gradient…). See [Selectable colours](https://docs.getoptical.app/en/guias/accesorios-y-addons/#selectable-colors-per-option).

## Design preset

A complete look for the panel in one click — **Classic**, **Modern** or **Dark** — from the Design tab. Not to be confused with a **form** template (the steps a new form starts from) or your theme's **product** template. See [Design & cart](https://docs.getoptical.app/en/guias/diseno-y-carrito/#design-preset).

## Accessory (cross-sell)

An **Accessories** step offers optional extra products (cases, cleaners, cords…) the customer can add or skip. Unlike add-ons, they live in their own step and don't depend on a specific option.

## Bundle

The **set** of main product + add-ons + accessories added to the cart in one click. Shopify links them natively via `parent_id`, so they cascade-delete and read together at checkout and in order emails. See [Design & cart](https://docs.getoptical.app/en/guias/diseno-y-carrito/).

## Graduation (Rx)

The customer's prescription data: sphere (SPH/PWR), cylinder (CYL), axis (AX), addition (ADD) and pupillary distance (PD), per eye (OD / OI). See [Prescription capture](https://docs.getoptical.app/en/guias/graduacion/).

## Metaobject / Sync

Each form is **published to Shopify as a metaobject**. Saving in the app isn't enough — you must **Sync** for changes to reach the storefront. See [Sync](https://docs.getoptical.app/en/guias/sincronizacion/).

---

# Build a form

> Configure the steps of your prescription configurator and assign it to a product.

Source: https://docs.getoptical.app/en/guias/crear-formulario/
Language: en

An Optical Form form is a **multi-step flow** the customer completes on the product page.

**Before you start**

If you haven't created the products behind your treatments and lens types yet, do that first — you need them to link add-ons. See [Before you start](https://docs.getoptical.app/en/empezar/antes-de-empezar/).

## 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

A form in **Draft** is invisible to everyone. To publish it:

1. **Forms** → open the one you want to use.
2. On the **Settings** tab, change **Status** from **Draft** to **Active**.
3. **Save**, then **Sync** — see [Sync](https://docs.getoptical.app/en/guias/sincronizacion/).

For it to actually appear you need all four at once: **Active**, **Synced**, **assigned to a product**, and the [app embed](https://docs.getoptical.app/en/empezar/instalacion/) enabled on your theme.

## Create the form

1. In the app: **Forms → Create form**.
2. 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 taken from the product's fabrication catalogue, 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.
3. Name it, choose the status (Draft / Active) and create.

## 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/OI): SPH, CYL, AX, ADD and PD. See [Prescription capture](https://docs.getoptical.app/en/guias/graduacion/). |
| **Reading Rx (grid)** | Magnification grid for reading glasses. |
| **File upload** | The customer uploads their prescription (image or PDF). See [File upload](https://docs.getoptical.app/en/guias/subir-receta/). |
| **Text input** | Free note from the customer. |
| **Accessories (cross-sell)** | Add extra products to the order. See [Add-ons & accessories](https://docs.getoptical.app/en/guias/accesorios-y-addons/). |
| **Graduation summary** | Shows the entered prescription before finishing. |
| **Contact lenses** | Per-eye pack, prescription read from the product's fabrication catalogue, 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

Each step has: an **Internal ID** (not shown to the customer), a **Title**, a **Description**, an **Input type** and several toggles:

- **Required** — the customer must complete the step to continue.
- **Hide from summary** — doesn't show the selection in the summary or footer chips (useful for routing-only steps).
- **Show 0 instead of "Included"** — shows `€0.00` on free options instead of the "Included" label.
- **Price shown on the options** — which amount each card of the step shows: the extra cost only ("+€25", the default), a starting price, the total price or the option's price alone. Each option can carry its own with **Price shown on this option**. The four modes, with an example, in [Pricing and charging](https://docs.getoptical.app/en/guias/precios-y-cobro/#the-price-on-each-card-four-modes).
- **If this step has only one option, pick it and skip the step** — off by default, single-select steps only. 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 with its label and moves straight to the next step: nobody sees a screen with a single card. It does not skip when the option carries selectable colours or an external action, nor when the skip would end the form. Off, a one-option step shows as it is — sometimes that screen is there on purpose.

## Anatomy of an option

In select steps, each **option** can carry:

- **Label**, **description** and **image** (from your Shopify Files or by URL).
- **Benefits** — up to four short tags under the description ("Less glare", "For screen use") saying what the shopper gets from that choice. They do not change the price and never reach the order. Ready-made tags translate themselves into the customer's language; ones you write you translate like any other field.
- **Help text** — optional. Fill it in and a "?" appears next to the option title that the customer opens to read a longer explanation (on hover or tap), so the description can stay short. Translates like any other field; its look is set in [Design › Tooltips and help](https://docs.getoptical.app/en/guias/diseno-y-carrito/).
- **Info badge** — visual text (e.g. `+250`) that does **not** affect the total. Put a price there without linking an add-on and the customer sees it but **doesn't pay it**: see [Pricing and charging](https://docs.getoptical.app/en/guias/precios-y-cobro/). It only shows on options that add nothing to the price: on an option with an add-on, the price mode you chose wins. For labels like “Best value” use the **Option label** (below); 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.
- **Option label** — a pill next to the option title: “Recommended”, “Best value”, “Most popular”… Click **Choose label** and pick a ready-made one (it translates itself into the customer’s language and comes with its colour) or write your own and pick its colour. One per option, on any choice step. It does not choose for the customer or change the order: to show it first, drag it up. The “Recommended” text is edited under [Design › Texts](https://docs.getoptical.app/en/guias/diseno-y-carrito/).
- **Incompatible with** — prevents combining it with other options.
- **Next step (on click)** — sequential, jump to a specific step, or **Submit (end)**.
- **Add-ons** — Shopify products billed as separate lines when the option is picked.
- **Selectable colours** — a row of swatches (tints, polarised, photochromic): the customer picks one colour and **only that one** is charged. Each colour is a variant of one of your products; several products form titled groups. See [Selectable colours](https://docs.getoptical.app/en/guias/accesorios-y-addons/#selectable-colors-per-option).
- **External action** — replaces "add to cart" with a message + button (appointment, WhatsApp, in-store only).

See [Add-ons, accessories & external actions](https://docs.getoptical.app/en/guias/accesorios-y-addons/).

## Conditional branching

Each option's **Next step** field defines which step the flow jumps to — so "Prescription glasses" and "Reading glasses" can take different paths from the same first step. The editor's flow diagram visualizes every jump.

## 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](https://docs.getoptical.app/en/guias/productos-y-colecciones/).
- **Design** — colors, typography and which data shows in the cart. See [Design & cart](https://docs.getoptical.app/en/guias/diseno-y-carrito/).
- **Sync** — publish changes to the store. See [Sync](https://docs.getoptical.app/en/guias/sincronizacion/).

**One product, one form**

A form can carry as many products as you like, but **each product takes a single form**. If you assign a product here that already belonged to another one, **this form takes it** — with no warning and no prompt: the previous form loses it silently.

Before moving products between forms, check which one they're in. And if what you want is for the frame to also sell **without** being configured, you need neither another form nor another product: your theme's button is still there ([Controlling how each frame is bought](https://docs.getoptical.app/en/guias/evitar-compras-sin-configurar/)). Only two different **forms** on the same frame require two products.

---

# Products and collections

> The two ways to say which products show a form, what wins when they overlap, and what happens with collections that hold many products.

Source: https://docs.getoptical.app/en/guias/productos-y-colecciones/
Language: en

A form only shows up on a product page if you have assigned it. There are **two ways** to do that, and they work together: product by product, or by collection. Both live in the form's **Products** tab.

## Product by product

Click **Add products**, pick the ones you want in Shopify's picker and you are done. Each chosen product is linked to this form, and the **Assigned products** card lists exactly which ones.

- **Each product takes a single form.** If you pick one that already belonged to another form, this form takes it, without asking. Before moving products around, check which form they are in.
- **Each product takes a few seconds**, and they are processed one after another: the app has to write to Shopify for every one of them. Ten products take about a minute; a hundred, about ten minutes with the tab open. If you are about to assign many, do it by collection.

## By collection

Click **Add collection** and choose one. From that moment on **every product in that collection shows the form**, including products that join the collection later, whether you add them by hand or an automated collection picks them up through its rules.

This works because the app never touches the products: it records the form **on the collection**, and the product page looks at which collections it belongs to when it loads. That is why:

- **It does not matter how many products the collection holds.** Assigning a collection of 5 products or one of 5,000 costs the same and takes the same: a couple of seconds.
- **Removing the collection** undoes the assignment for all its products at once, on the next load of each product page.
- The **Assigned products** card does not list products that arrive through a collection: only the ones you assigned one by one. The tab's counter tells you how many collections the form has.

**The collection must be published to the Online Store**

The product page only sees collections available on the **Online Store** channel. A collection not published to that channel does not show the form on its products even if you assigned it. If a product in an assigned collection is not showing the button, check that first.

## What wins when they overlap

A product can be assigned directly and also belong to one or more assigned collections. The rule is fixed:

1. **The product's own assignment always wins.** If a product sits in a collection assigned to form A but you assigned it by hand to form B, it shows B.
2. Without a direct assignment, it shows the form of **the first of its assigned collections**. When a product sits in two collections assigned to different forms, that order is decided by Shopify, not by the app, so do not rely on it.

In practice: use collections for the bulk of the catalogue, and direct assignment for the exceptions — the frame that needs a different form, or the product you want out of the general rule.

## What does not change

- The form has to be **Active and synced** to appear, however it is assigned. When you assign a collection, the app syncs the form first if it needs to.
- Products without an assignment do not show the button, but your theme keeps **its own buy buttons**. How to handle that is your call: [Control how each frame is bought](https://docs.getoptical.app/en/guias/evitar-compras-sin-configurar/).
- If you delete a form, its assignments — products and collections — are cleaned up with it.

---

# Controlling how each frame is bought

> Your theme has its own buy buttons. Decide whether that frame can be bought without lenses, then apply your decision on the product page, the sticky bar and the listings.

Source: https://docs.getoptical.app/en/guias/evitar-compras-sin-configurar/
Language: en

Before you touch anything, a decision that is yours to make: **can that frame be bought without lenses?**

Both answers are valid, and there are opticians running on each. The app has no opinion here: it leaves both routes open and you choose, product by product.

| | When it makes sense |
|---|---|
| **Configured only** | The usual case. The frame sells with its prescription and never on its own |
| **Both, side by side** | You also sell bare frames — to other professionals, or to customers who will have lenses fitted at their own optician |

The one thing that doesn't work is not having decided, because then your theme decides for you. This page shows you how to see what your product page does today, and how to leave it the way you want it.

## The two buying routes

Optical Form adds **its** button to the product page. Your theme's buttons are **still there**, and they do something different:

| | What it does |
|---|---|
| **The Optical Form button** | Opens the form, collects the prescription, adds frame + lenses + treatments |
| **Your theme's button** | Adds the frame, and that's it |

The app **doesn't remove your theme's buttons**, and that's deliberate. Your catalog almost certainly has products that sell as-is — cases, cleaning fluid, accessories, non-prescription sunglasses — and those **need** their normal button. Removing it on our own would break half your store.

## The 30-second test

It works for either decision, because it assumes nothing: it just tells you what your product page does today.

1. Open a product page that uses a form, **as a customer would**.
2. **Don't touch** the Optical Form button.
3. Try to buy the frame any other way.

- **If you manage it and you wanted that** — you're set, both routes are open. Skip to [If you want both buttons](#if-you-want-both-buttons); there's one clarity detail worth getting right.
- **If you manage it and you didn't want that** — read on. There are three ways in, and usually only the first one gets closed.

**If your answer is "configured only", decide before you open**

An order that comes in through the theme button **looks perfectly normal**: it's paid, it lands in your admin, the customer gets a confirmation. That it has no prescription on it surfaces in the lab, days later, with the money already taken and the customer waiting for their glasses.

Nothing is breaking — that order simply doesn't carry what you need to make the lenses. Which is why it's worth running this test **before** you open the store to the public, rather than once people are already coming through.

## Where the direct-buy buttons are

There are three, and they're on by default in most modern themes. Worth knowing where they are whichever way you decided:

**1. The buy button on the product page**
The usual "Add to cart", next to the price and the variant picker.

**2. The bar that appears as you scroll**
The easiest one to miss, because **it isn't visible when the page loads**. Scroll to the bottom of a product page: many themes pop up a fixed bar with the photo, the price and a buy button. In **Horizon it's on out of the box**.

**3. Quick add on listings**
On collection pages, many product cards carry a button to add without opening the product. There the customer never even sees your form.

**Three separate doors**

Closing only the first is what usually happens. If your decision is that the frame doesn't sell on its own, the other two keep selling it.

## If you want that frame sold configured only

The idea is simple: **a separate product template** with no native buy buttons, used only on the products that carry a form. The rest of your catalog stays exactly as it is.

### Step 1 — Create the template

1. **Online Store → Themes → Customize**.
2. At the top, in the template selector, pick **Product**.
3. Open the selector and click **Create template**.
4. Give it a recognisable name, for example `prescription`. Base it **on** the product template you already use.

### Step 2 — Remove the direct-buy routes

With the new template open:

- Select the **buy buttons** block and **remove** it (or hide it with the eye icon).
- In the product **section settings**, find the **sticky buy bar** option (in Horizon, *Sticky add to cart*) and **turn it off**.
- Keep the **Optical Form** block — that's what carries the sale now.

Save.

### Step 3 — Assign the template to your frames

Under **Products**, open each frame that uses a form and, in the right sidebar under **Theme template**, choose `prescription`. Save.

You can do it in bulk: select several products → **Actions** → change template.

### Step 4 — Quick add on listings

This one lives in **collections**, not on the product page. In the editor, go to the collection template and **turn off quick add** on the product cards.

If your theme won't let you disable it for some products only, you'll have to turn it off entirely, and that hits the products you do sell on their own too. It's the point most worth pausing on: what that shortcut earns you, against how many unglazed frames would slip through there.

### Step 5 — Run the 30-second test again

Try once more to buy without opening the form. You shouldn't be able to — not on the product page, not on scroll, not from the collection.

### Check this before you open to the public

- [ ] The new template has no buy button on the product page
- [ ] The sticky bar on scroll is turned off
- [ ] Collection cards don't allow quick add
- [ ] Every frame with a form uses that template
- [ ] You tried to buy without configuring **and couldn't**
- [ ] A test order arrives with the prescription in the line item properties

Once all six are ticked, that frame only sells configured.

## If you want both buttons

Nothing special to do: it's the out-of-the-box state. Your theme's button and the Optical Form button sit on the same product page, and the customer picks.

The one thing this asks of you is **that it's clear which does what**. Two buttons in a row both reading "Add to cart" are a trap: the customer hits the first one they see and walks off with a bare frame believing they bought glasses. That ends in a return, and the return is yours.

- **Name the Optical Form one.** In **Online Store → Themes → Customize**, click the **Optical Form** block and set *Button text* to something that says what it does: "Configure with my prescription", "Add prescription lenses". See [The product button](https://docs.getoptical.app/en/guias/boton-del-producto/).
- **Name your theme's one too**, from your theme settings: "Buy frame only".
- **Make the one you want to win stand out.** If prescription is your main sale, that's the coloured button and the other one is quieter.

**If you sell in several languages**

If you write your own *Button text*, **that text shows the same in every language**: it stops being translated for you. With a single-language store it makes no difference; with several, either translate it yourself from each language's editor, or leave the field empty and use the app's own text. See [Languages & wording](https://docs.getoptical.app/en/guias/traducciones/).

And even with both buttons, consider turning off **quick add on listings**: there the customer sees neither button nor the difference between them, so the choice you're offering never actually reaches them.

## How do I…

**…sell the same frames with and without prescription?**
Two ways, and the right one depends on how you want it to look:

- **One product with both buttons** — the section above. The customer sees one page and chooses right there. It's the most direct route and the one that adds least to your catalog.
- **Two separate products** — one on the `prescription` template with a form, one normal. More work, but it lets you set different prices, photos and copy, and they appear separately in collections and search.

**…if my theme won't let me remove the buy button?**
Some themes won't let that block go. Then the route is the **Custom CSS** field on the app embed, hiding it only on that template. Write to us and we'll send you the rule for your theme.

**…test it without publishing?**
Duplicate the theme, make the changes on the copy and preview it. Remember the app's Setup guide checks your **published** theme, so the embed and block steps will still reflect whichever theme is live.

---

# Prescription capture

> What every value on a prescription means, how it is captured per eye, and how it reaches the order for your lab.

Source: https://docs.getoptical.app/en/guias/graduacion/
Language: en

If you come from Shopify rather than from optics, start with the glossary. Setting this step up is far easier once you know what you are asking the customer for.

## Glossary: what each value means

A spectacle prescription is a list of numbers, one set per eye. Here is what they mean:

| Abbreviation | Name | What it does |
|---|---|---|
| **OD** | Right eye | From the Latin *oculus dexter*. It is the right eye in every country |
| **OS** / **OI** | Left eye | **OS** in English (*oculus sinister*); Spanish prescriptions write **OI** |
| **SPH** | Sphere | The main correction. **Negative** for short-sightedness (poor distance vision), **positive** for long-sightedness (poor near vision) |
| **CYL** | Cylinder | Corrects astigmatism: the cornea isn't perfectly round, so the image comes out distorted. Usually negative, and can be 0 |
| **AX** | Axis | The angle that cylinder sits at, from 0 to 180 degrees. Only meaningful when there is a cylinder |
| **ADD** | Addition | Extra power for close-up vision. Appears on progressive and bifocal lenses, from the mid-forties onwards. Always positive |
| **PD** | Pupillary distance | The millimetres between the centre of one pupil and the other. Used to centre the lenses in front of the eyes. Adults are typically between 54 and 74 mm |

Dioptres are measured in steps of 0.25. That is why the dropdowns jump like this: `-1.00`, `-1.25`, `-1.50`…

**Why it matters that the customer copies it correctly**

These numbers get manufactured exactly as entered. A customer who flips a sign, or swaps the right eye for the left, receives glasses they cannot see through. That is why it is worth adding a summary step so they confirm before paying.

## The two step types

- **Graduation (Rx)** — a full prescription, with every value above. For genuine prescription eyewear.
- **Reading Rx (grid)** — just a magnification (`+1.00`, `+1.50`…). For pre-made reading glasses, the ready-to-wear kind that carry no prescription.

## Graduation (Rx) step

Captures the values for each eye: **OD** (right) and **OS** (left).

### Field ranges

Every field has a configurable **Min**, **Max** and **Step**. Set them to what your lab can actually make: if you don't work below -8, set that as the minimum and customers can't order it.

- **Show ADD field** — turn it on only if you sell progressives or bifocals. On ordinary glasses it is noise.

### The axis switches on with the cylinder

All three values for each eye — sphere, cylinder and axis — start **empty**. Not at `0.00`: zero is a real clinical value, it means "no astigmatism", and it can't be confused with "I haven't filled this in yet".

The **axis** field also starts **switched off**, greyed out and untouchable. It only switches on once the customer enters a cylinder other than zero, because an axis with no cylinder means nothing — it is the angle of something that doesn't exist. If the customer goes back and clears the cylinder, the axis empties and switches off again.

And the other way round: **if there is a cylinder, the axis is required.** The app won't move past the step until it is filled in.

**The cylinder can come in positive too**

Spanish prescriptions usually carry the cylinder as a negative number, but much of Europe writes it positive, and both notations are equally valid. The axis switches on for **any** cylinder other than zero, whatever its sign.

There is nothing to configure here: it works this way in every form, always.

### Pupillary distance

- **Show PD** — adds pupillary distance capture.
- **How the customer enters it** — *free text* (they type the number; the historical behaviour) or a *dropdown with the allowed values*. The dropdown avoids typos and values your lab cannot make; free text is faster for someone who knows their PD. It starts at "—": nobody has a default PD.
- **Ranges in mm** — the single value (40 to 85 by default, in 0.5 steps) and the per-eye value (20 to 45). They are both what the dropdown offers and what the free text accepts: a customer who types 6 instead of 63 gets a warning, not an impossible order.
- **Single or per-eye PD** — one number (the usual case), or one per eye. The customer switches with a toggle.
- **Validation messages** — what they are told if they leave it blank.

**Simple by default**

The per-eye PD toggle starts **off**: the customer types a single number unless they turn it on. Most prescriptions carry one value, so the common case stays frictionless.

### The customer gets help on every field

Your customer is not an optician. They are holding their prescription and do not know what a cylinder is, whether the axis carries a sign, or which of the numbers is the pupillary distance. That is why every field in the step has a small **"?"** to the right of its label — SPH, CYL, AX, ADD and the PD title — which opens a short, plain-words explanation on hover, tap or keyboard: what the value is, which sign it takes and where to find it on the prescription.

It comes switched on in every form, with texts already written in your store's language. There is nothing you need to do.

What you can do:

- **Switch it off** — in the step settings, untick *Show a help icon next to each prescription field*. All five "?" disappear at once.
- **Rewrite the texts** — under *Labels & translations* in the same step, heading *Help texts*. Each box shows up empty with the default text **in grey, in your store's language** — the same text your customer reads. Type over it to say it your way — for instance, with the notation your lab uses — and **if you empty the box, it goes back to the default** (how it works, in [Languages & wording](https://docs.getoptical.app/en/guias/traducciones/)). The ADD and PD texts only appear when those fields are enabled.
- **Translate them** — like every other label, from each language's tab. See [Languages & wording](https://docs.getoptical.app/en/guias/traducciones/).

The "?" icons use the same colour, size and background settings as the ones on the form's options. Change them under [Design & cart](https://docs.getoptical.app/en/guias/diseno-y-carrito/), section *Tooltips and help*.

### And a sample prescription

At the top right of the step there is a link, **"How to read your prescription"**, which opens a sample prescription built with **your own labels**: two eyes with SPH, CYL and AX (and ADD if you have it enabled), and the PD underneath. The customer taps a column and the app highlights it and explains that value with the same help text as the matching "?". It is what helps most someone holding a paper prescription: they see where each number sits in an example that looks like theirs.

It comes switched on. Turn it off in the step settings (*Show a "How to read your prescription" link…*), and rewrite the link text, the caption above the sample and the hint under it in *Labels & translations*, under *Sample prescription guide*. The explanations are the same as the "?" ones: change one and it changes in both places.

### Changing the labels

Every text in the step can be rewritten without touching code. Before you do, read **[Languages & wording](https://docs.getoptical.app/en/guias/traducciones/)** — the boxes come pre-filled in English and there is a catch.

## Graduation summary step

Shows the customer the prescription they just entered **before** adding to cart: a table with your labels as headers (SPH, CYL, AX and ADD if present), one row per eye and the PD underneath — the same layout as the sample prescription in the previous step, so they never have to guess which number is which.

Add it whenever you capture full prescriptions. It is the last chance for the customer to spot their own mistake, and it saves you returns.

If the customer **uploaded a photo** of their prescription instead of typing it, the summary shows them **the image**, not just the file name. That is the difference between confirming `prescription.png` and confirming the numbers that are about to be manufactured: a wrong file — a gym receipt, a screenshot of something else — is obvious at a glance. If they uploaded a **PDF**, which can't be drawn, a document icon appears with the name and the size.

## Reading Rx (grid) step

For pre-made reading glasses, where the customer only picks a magnification.

- **Minimum**, **maximum**, **step** and **columns** of the grid.
- **Value prefix** — usually `+`, so it reads `+1.50`.
- Live preview of how many values it generates.

## How the prescription reaches the order

When the customer adds to cart, the prescription travels **inside the Shopify order**, alongside the product. You see it on the order detail in your usual admin, and it carries through to whatever you send your lab.

It is written one line per eye, each value **preceded by its field's label** — yours, in the customer's language — so anyone can read it without knowing the order of the numbers:

```
Frame type: Prescription glasses
Lens type: Standard thin lenses
OD: SPH -2.50 · CYL -1.25 · AX 90° · ADD +1.50
OS: SPH -3.00 · CYL 0.00 · AX — · ADD +2.00
PD: 63
```

An eye without a cylinder has no axis: it prints `AX —`, just like the addition when only one eye has it — never a made-up `0°` an optician would read as a real axis. It is the same line the customer sees in the cart, at checkout and in the confirmation email.

If you have an integration with your practice software, the same prescription also travels in the hidden property you agreed with it, in the format that software expects (there an empty axis does go as `0`, because that is what its contract asks for). See [Integration](https://docs.getoptical.app/en/desarrolladores/integracion/).

**The prescription can't be removed from the order**

There is a checkbox to keep steps out of the cart, but **it does not appear on the steps that carry the prescription**, nor on photo upload. An order for prescription eyewear with no prescription on it cannot be filled, so the app won't let you reach that state even by accident.

What you do decide is whether the **customer** sees those values. See [Design & cart](https://docs.getoptical.app/en/guias/diseno-y-carrito/).

If the customer uploads a photo of their prescription instead of typing it, the order shows the file name. See [Uploading the prescription](https://docs.getoptical.app/en/guias/subir-receta/).

---

# File upload

> Let the customer attach their prescription as an image or PDF.

Source: https://docs.getoptical.app/en/guias/subir-receta/
Language: en

The **File upload** step lets the customer attach their prescription (photo or PDF) instead of typing the values by hand. Great as an alternative to the [Graduation](https://docs.getoptical.app/en/guias/graduacion/) step or alongside it.

## Configuration

- **Accepted file types** — comma-separated extensions, e.g. `.jpg,.png,.pdf`.
- **Max size (MB)** — file weight limit.

## Dropzone

All text is editable: the dropzone main text, the secondary hint text, the browse button, and the selected-file state texts (**Change file** / **Remove file**).

## Validation

Customizable messages for:

- **File required** — when the step is required and nothing is attached.
- **File too large** — use `{maxSize}` as a placeholder.
- **Invalid file type** — use `{types}` as a placeholder.

## In the summary

You can set the **chip label** that represents the uploaded file in the selection carousel and the summary.

If the upload sits inside a **Graduation** step and you put a [Graduation summary](https://docs.getoptical.app/en/guias/graduacion/#graduation-summary-step) after it, that is where the customer sees **the image they uploaded**, not just its name. For a PDF, a document icon appears with the name and size. Nothing to switch on.

---

# Add-ons, colors, accessories & external actions

> The ways to sell extras, offer colors inside an option and route options outside the cart.

Source: https://docs.getoptical.app/en/guias/accesorios-y-addons/
Language: en

Optical Form has four mechanisms to monetize and route beyond a plain selection. Don't mix them up.

## Add-ons (per option)

An **add-on** is a Shopify product linked to **one specific option**. When the customer picks that option, the add-on is added to the cart as a **separate line item** and adds its price to the live total.

- Configured in the **Add-ons** section of each option.
- Each add-on has a **quantity** — set **2** for items billed in pairs (e.g. lenses).
- **Its price is the surcharge**, not the total: the frame already has its own. See [Pricing and charging](https://docs.getoptical.app/en/guias/precios-y-cobro/).
- Typical examples: the lens type, a treatment (anti-reflective, blue filter), a fitting service.

**Create products for add-ons**

Add-ons are real Shopify products. Create them for lens types, treatments and services with the **Unlisted** status (purchasable, but absent from collections and search; an unpublished or Draft product **can't be added to the cart**), then link them. That way Shopify bills them, includes them on the order and sends them to your lab.

**Add-ons belong to this store**

An add-on stores the ID Shopify gave that product **in your store**, and that number doesn't exist in any other. That's why add-ons **are not copied** when you export a form to another store, and why the sample template ships without them: you link your own products. Full explanation in [Copying a form to another store](https://docs.getoptical.app/en/guias/copiar-formulario/).

**Add-ons are all charged; colors, only the chosen one**

If you link **several variants of the same product** as add-ons — gray, amber and green of one tint — a customer who picks that option gets **all three** in the cart and pays for all three. Almost always what you wanted was for them to **pick one**: that is what [selectable colors](#selectable-colors-per-option) are for. The editor spots it and offers the fix with a notice and a button, **Make them selectable colors**; the picker opens with those variants already ticked and, on confirm, they move from add-ons to colors. Cancel and nothing changes.

## Selectable colors (per option)

An option can carry a **row of color swatches** underneath: perfect for polarized, tinted or photochromic lenses that come in several colors. The customer taps a color and **only that color is charged** — unlike add-ons, which all apply, colors are alternatives. Tapping the card without picking a color only **opens** it (dashed border and the "Choose a color to continue" line): the option counts as chosen once the customer taps a color.

- Configured in the **Selectable colors** section of each option, with the same product picker as add-ons: **each color is a Shopify variant**, with its own SKU and price. That way Shopify bills it, includes it on the order and your lab receives the exact reference of the chosen color.
- Each color has a **name** (what the customer reads, translatable like any other text) and a **swatch**, which is the **variant's own image**: give each color variant its swatch photo in Shopify and there is nothing else to set up. Only when a variant has no image is the CSS color field used — `#8b5a2b`, or a gradient like `linear-gradient(#555, #ddd)`.
- If the colors have different prices, the card shows the cheapest until the customer picks — it never advertises less than what they may end up paying.
- Hovering a dot shows its **name** (and the surcharge, if you leave that on under Design › Options); if the colors cost different amounts, the card says "From" until the customer picks.
- The customer **cannot continue without picking a color**: an option with colors and no color is half a choice, and the order would leave without the reference your lab needs.
- Every option — and every color group — accepts a **help text**: a "?" appears next to the title that the customer opens to read a longer explanation. See [Build a form](https://docs.getoptical.app/en/guias/crear-formulario/#anatomy-of-an-option).

**Add-on or color?**

Use an **add-on** for something the option always includes (a treatment, a service). Use **colors** when the option comes in several versions and the customer must pick exactly one.

**What's sold out shows before it's chosen**

When the configurator opens, the app checks the stock of every add-on, colour and accessory in the form. Whatever cannot be sold — a variant tracked at 0 that doesn't allow overselling, a product in draft or archived, a product that **isn't on the Online Store sales channel**, or one that was deleted from Shopify — shows **disabled with "Sold out"**: the option card, the accessory card, and for colours the dot **struck through**, like your theme's variant picker. The customer can't pick it, and if it was already picked — on an earlier visit, or before the stock answer arrived — it is removed and the drawer says so: **"X is no longer available. Go back and choose another option."** If that step requires an answer, they can't continue or add to the cart until they choose another one. Under **Design › Options** you can prefer **hiding** it instead of disabling it; if hiding would leave a step with nothing to pick, they show disabled anyway. An **Unlisted** product still sells: it only disappears from collections and search.

The editor warns you of the same from your side, without you clicking anything: when you open the **Steps** tab it checks the form's products and puts a badge next to the affected add-on, colour or accessory — "Sold out", "Draft", "Not on Online Store" or "Deleted". If any of them is in draft, archived or off the Online Store channel, a red warning also shows above the steps, **"Products in this form that cannot be added to the cart"**, listing each product and its reason: while it stays that way, Shopify would reject the whole order of anyone who picked it. How to fix it: [put a product on the Online Store channel](https://docs.getoptical.app/en/empezar/antes-de-empezar/#how-to-put-a-product-on-the-online-store-channel). **Check prices** shows the same list.

**Color groups? One product per group**

Want grouped colors — Classic, Fashion, Gradient — like the big eyewear stores? Create **one Shopify product per group** ("Classic Tint", "Fashion Tint", "Gradient Tint"), each with its color variants, and link the variants of all three **under the same option**. The app detects that they come from different products and turns the option into a **dropdown**: selecting it unfolds the groups, one per product, each with its **title** (the product name, editable and translatable), an optional **description** and its colors. If the groups cost different amounts, each shows its price and the option header shows none; if they cost the same, the price sits in the header. The customer taps the color they want: one gesture picks both the group and the color, and only that variant goes to the order.

## Accessories / cross-sell (own step)

An **Accessories (cross-sell)** step offers **optional** extra products in its own step: cases, cleaners, cords, etc.

- **Select products** — choose what's offered as cross-sell.
- **Show skip option** — shows a "Continue without accessories" card. When on, the step is optional even if marked *Required*.
- Editable labels: skip label and description, selection error and summary chip.

**Key difference:** an add-on depends on picking an option; an accessory is a standalone cross-sell step.

A sold-out accessory shows disabled with "Sold out" (or hidden, per Design › Options), just like add-ons and colours: see the note above.

## External action (per option)

Instead of adding an option to the cart, you can turn it into an **external action**: it shows a custom message and button.

- **Message** — e.g. "In-store only".
- **Button text** — e.g. "Book an appointment".
- **Button URL** — supports `https://`, plus `tel:`, `mailto:`, `sms:` and `https://wa.me/`.

Useful for products only available in a physical store, appointment bookings or direct contact links (WhatsApp, phone, email).

---

# Pricing and charging

> Where every unit of the total comes from, why an add-on's price is the surcharge and not the total, and the mistakes that make you charge too much or too little.

Source: https://docs.getoptical.app/en/guias/precios-y-cobro/
Language: en

This page explains **where every penny the customer sees comes from**. If a total doesn't add up, the answer is here.

## The formula

```
Total = frame price
      + each chosen add-on's price × its quantity
      + any accessories the customer adds
```

That's it. There are no hidden margins and no maths of our own: **every line is a Shopify product with its own price**, and the total is the sum.

That's why the form total and the cart total always match — it's the same calculation.

## 🔴 The add-on is the surcharge, not the total

The most expensive mistake, and the easiest to make.

The frame **already has a price**. When you create the product "Thin lens 1.60", its price should be **what you charge on top** for that lens, not what the whole pair is worth.

| Frame | Thin lens | Customer pays |
|---|---|---|
| 100 | **15** ✅ | 115 |
| 100 | ~~115~~ ❌ | 215 |

It sounds obvious written down, but it's easy to think "complete pair" while creating the product. The simple rule: **if the frame alone is 100, your add-ons are what you add to that 100**.

## Anything included: create it at 0

Creating a product worth 0 can seem pointless, but there are two reasons:

1. **The customer sees "Included"** instead of a blank. It communicates value: the standard lens comes with the price.
2. **The line reaches the order**, so your lab knows which lens to fit. Without a product, that information travels nowhere.

Typical example: *Single vision standard 1.50 — 0.00*.

**Changing the label**

If you'd rather it said something else instead of "Included", change it in **Appearance → Included label**. Leave it empty to use the app's own translated text.

## Quantity: the lens case

Every add-on has a **quantity**. It defaults to 1.

Lenses sell **in pairs**, so if your product price is *per lens*, set **quantity 2**. If the price is already for the pair, leave it at 1.

Both approaches work. What doesn't work is mixing them without noticing: pick one and apply it to every lens.

## 🔴 The badge doesn't charge

Each option can carry an **informational badge**: a small piece of text next to the name.

> **It's text only. It adds nothing to the total.**

If you write `+30` in the badge but don't link an add-on, the customer **sees 30 and pays 0**. It's a silent error: nothing breaks, you simply undercharge, and you find out when reconciling.

**Use it for things that aren't prices** — "In store only", "Best seller", "New" — and let add-ons carry the prices, since they're what actually charges.

## What the customer sees while choosing

- **The total updates live** with every selection.
- Options with an add-on show their surcharge; 0-priced ones show "Included".
- The surcharge reads **"+$70.00"** by default. You can change how it's written under **Design → Interface texts → Prices and summary → Option surcharge**, per language: `{price} extra` gives "$70.00 extra" and `Add {price}` gives "Add $70.00". It applies on the card and on colours with a surcharge. Without the "+", shoppers may read the amount as the total price: if what you want is to show the total, use the **Total price** mode on the option or the step; and if you want the option's price with no sign, **Option price only** ([the four modes](#the-price-on-each-card-four-modes)).
- You can hide per-option prices under **Appearance → Show price adjustments** if you'd rather show only the total.
- In the **Starting price** mode (the card shows what the set would cost, not the surcharge), the word **"From"** only appears on options from which the price **can still rise**: because a priced treatment, a colour with a surcharge, contact lenses or an accessories step come after them. An option that ends the form, or is only followed by free steps, shows its total with no "From". Nothing to configure: the word follows each option.

### The price on each card: four modes

You choose which amount an option's card shows in the form editor: on each step, the **Price shown on the options** dropdown; and if one option needs something different from the rest of its step, on that option, **Price shown on this option**. With an $85 frame and an option whose add-on costs $25:

| Mode | The card says | What it counts |
|---|---|---|
| **Extra cost only** | "+$25.00" | What that option adds. The default. |
| **Starting price** | "From $110.00" | The frame, what's been chosen so far, the option and the cheapest still left to choose. For a first step that splits into paths. |
| **Total price** | "$110.00" | The frame, what's been chosen so far and the option. For a step after which nothing else is charged. |
| **Option price only** | "$25.00" | Only what that option costs: no "+", no frame and nothing chosen on earlier steps. |

**Option price only** is for steps where each option reads as a product with its own price — a $59 lens package — rather than as an extra. It matters most when an earlier step has already charged something: with a $35 rimless mounting fee chosen earlier, **Total price** shows that package as "$94.00" (it adds what's already chosen, so the card agrees with the footer total) and **Extra cost only** as "+$59.00". With **Option price only** it says "$59.00", and the fee stays on its own step and in the total.

Three details of that mode:

- A 0-priced option still shows "Included", just as in **Extra cost only**.
- If the option has colours with different surcharges, it says "From" until the customer picks one.
- The surcharge text you wrote under Design doesn't apply: the card shows the amount alone.

The mode only decides **what the card reads**. The footer total, the cart and what gets charged are the same in all four.

## In the cart

The frame and each extra are **separate lines**, visually grouped under the frame:

```
Archer frame ........................... 100.00
  └ Single vision thin 1.60 ............. 15.00
  └ Premium anti-reflective ............. 30.00
                                 Total   145.00
```

Child lines have **no quantity stepper and no remove button**: they're part of the set. Removing the frame removes them all.

Them being separate lines isn't cosmetic: it's what lets Shopify bill each item, break it out on the order and send it to your lab.

## Discounts and taxes

- **Automatic discounts** and codes work as normal, but many apply **at checkout**, not in the cart. A cart total that doesn't show the discount doesn't mean it won't apply.
- **Taxes** follow your store's configuration, like any other product.
- If you sell in **multiple countries or currencies** (Shopify Markets), the form shows the prices **of the visitor's market**: the frame and every surcharge too, with whatever price adjustment or currency that market has. So the total matches the cart and the checkout for that country. Nothing to configure: it switches on by itself when the store sells in more than one country. Check from the same country as your customer, or with your theme's country selector.

## Check before you open

Place a test order yourself and check three things:

- [ ] The form total **matches** the cart total
- [ ] The cart total **matches** the checkout total
- [ ] The order in your admin has **each extra as its own line**, with its price

If all three line up, your charging is set up correctly.

## How do I…

**…make a treatment free on some frames only?**
Create two forms, one with the add-on at 0 and one at the normal price, and assign each to its group of products.

**…raise the price of a treatment?**
Change the product's price in Shopify. No need to touch the form or re-sync: the add-on points at the product, and the product sets the price.

**…make a lens package show its own price, with no "+" and nothing added to it?**
On the packages step, set **Price shown on the options** to **Option price only** and save. Each card will say what that package costs; the footer total still adds the frame and what was chosen before.

**…see how much each extra makes me?**
Because they're real Shopify products, they appear in your product sales reports like any other item.

---

# Design & cart

> Customize colors, typography, behavior and which form data shows in the cart.

Source: https://docs.getoptical.app/en/guias/diseno-y-carrito/
Language: en

Each form's **Design** tab controls its appearance, its behavior and what information reaches the cart. Each section governs a specific area of the drawer.

## Behavior

Turn drawer sections on or off:

- **Show price adjustments** — shows the price difference next to each option (e.g. `+$10.00`).
- **Show progress bar** — indicates how far the customer has left.
- **Show summary step** — adds a final review step before adding to cart.
- **Show total on Next button** — shows the running total on every step, not just at the end.

## Drawer

Position and shape of the panel: **width** (px), **position** (right / left / full screen), **overlay opacity** (%) and **border radius** (px).

### Full screen (desktop)

With the position set to **Full screen**, on desktop the configurator fills the screen split **in equal halves**: on the left, the **product image** — with the name and variant — and the **live summary** of what the customer has configured so far, with its total; on the right, the steps. If the customer switches variants inside the form (a frame color, a pack), the photo and name on the left switch with them.

**Max width** (shown when this position is selected): at 0 the area uses the whole screen; above 0 the content centers and the leftover becomes side margins — so on a very wide monitor the configurator does not sprawl.

**Image column background** (also only in this position): the color of the whole left half — photo, summary and its side margin. Empty follows the card background.

**Opening animation**: full screen does not slide in like the drawer; it fades in with a short gesture you pick here — zoom, rise, two halves (the photo from the left, the steps from the right) or fade only. Visitors with "reduce motion" enabled on their device always get the plain fade — and the same goes for the side panel: it fades in instead of sliding, and steps change without moving across. Nothing to set up: the app follows the preference on the customer's device.

On **mobile it keeps the regular drawer**: a split screen needs width to exist. Nothing else changes — same steps, same prices, same cart.

**Accessibility**: the panel is a real modal dialog. While it is open, the rest of the page is inert for the keyboard and screen readers; focus moves in on open, never escapes with Tab and returns to the button on close. The progress bar announces which step the customer is on ("step 2 of 5"), everything focusable carries a two-layer focus ring that shows on any background colour, and the browser's Back button goes back one step (on the first one, it closes the panel without leaving the product page). Nothing to set up.

## Tooltips and help

Every option (and every color group) accepts a **help text**: fill it in and a "?" appears next to the title that the customer opens to read a longer explanation, so the description can stay to one line. It shows on hover or tap, and closes on a tap outside.

This section styles that bubble, the "?" on [the prescription fields](https://docs.getoptical.app/en/guias/graduacion/#the-customer-gets-help-on-every-field) **and** the tooltip with each color's name: **background** and **text** (empty, they follow the form colors: white and black by default, with a hairline border), **radius** (0 by default), horizontal and vertical **padding**, **font size**, the help bubble's **max width** (0 = as wide as the text column) and the **"?" icon color and size**.

If you would rather the color tooltip did not also say the surcharge ("Gray (+€80.00)"), turn it off under **Design › Options › Show the surcharge in the color tooltip**: only the name remains, and the price still shows under the row once a color is picked.

## Design preset

A whole look in one click, before you touch anything else:

- **Classic** — the panel as it has always been, flush with the edge and compact.
- **Modern** — more air, soft corners, thin borders and a considered type scale; the panel floats as a card set off from the edge. It's what the sample forms ship with.
- **Dark** — Modern's layout over a charcoal ground, graphite cards, light ink and a vermilion accent. Made for sunglasses and premium frames: a configurator that reads as part of the product. It's the only preset that **brings its own colours**.

Classic and Modern change spacing, corners and text sizes, **never your colours**. Dark does write them when you pick it, and restores the defaults when you switch back — the panel tells you if you've changed anything since applying it, with a button to re-apply.

For a dark panel use the `on-dark/` set from the [icon pack](https://docs.getoptical.app/en/guias/iconos/): on a dark ground, the light-ground icons vanish.

## Colors

**Accent**, **text on accent**, **background**, **text**, **muted text** and **borders** — to match your brand. They default to a neutral accent.

## Typography

Sizes and weights for **header**, **step title**, **step description**, **option text** (title, description, price and price weight) and the **benefit chips**. Under the step title, **Gap between title and description** (8px by default) moves only that space; the header-to-options distance does not change.

The chips ship on **automatic**: they sit one point below the option description and follow it if you change it, which is what keeps the card's hierarchy. Give them a size of their own only if you need to; sliding back to zero returns to automatic.

## Options

Each card's style: horizontal/vertical **padding**, **gap** between options, **border width**, **image size** and the **free-option label** ("Included"). On a step where no option carries a price — how you send us your prescription, for instance — the cards show no such label: "Included" only appears next to a surcharge. And the air inside the card: **space to the right of the text** before the price (24px on desktop and 0 on mobile by default), **gap between the option title and its description** (2px by default) and **space above the benefit chips** (12px by default). Also the **gap between the option image and its text** and the **image corner radius**; the **image fit**: **Whole image** (the default) shows all of it inside its square, leaving space around it if it isn't square; **Crop to fill** covers the whole square and trims the edges, handy for photos; the **benefit chips** (padding, pill / rounded / square shape and gap between chips); the **gap between the color dots**; and the **accessory card** (its padding and the gap from image to text). They all default to the values the drawer used until now: nothing changes until you touch them. The exception is the image fit: the image used to be cropped every time, and now it shows whole by default. A square image, the usual case, looks the same.

For options with [selectable colors](https://docs.getoptical.app/en/guias/accesorios-y-addons/#selectable-colors-per-option): the **size of the color dots** (under 32px they get hard to tap on a phone), whether the tooltip that appears over a dot also shows the **surcharge** ("Gray (+€80.00)") or just the name, and the **"Choose a color to continue"** text — you can rewrite it, and decide whether it shows under the color row or only as the note above the Next button.

**Sold-out add-ons, colors and accessories**: what the drawer does with what cannot be sold right now — show it **disabled with "Sold out"** (the default; for colors, the dot struck through) or **hide it**. If hiding would leave a step with no options, they show disabled. See [what's sold out shows before it's chosen](https://docs.getoptical.app/en/guias/accesorios-y-addons/#selectable-colors-per-option).

## Navigation

Progress bar and buttons: **bar height**, button **size/weight/padding**, the **footer selection carousel** (show on desktop/mobile, prefix with step name) and the **step counter** (separator word, e.g. "2 of 4").

**Space kept free at the right of the footer** — if your store has a chat bubble in the bottom-right corner (WhatsApp, Tidio, Gorgias…), it lands right on top of the panel's *Next* button. This setting leaves that spot empty so the chat floats over nothing: about 72 px clears the usual bubble. It is 0 by default and the footer does not change.

**Show the GetOptical attribution in the header** — off by default on the paid plan. When on, a 24-pixel icon (the icon alone, no text) sits in the top-left corner of the configurator and links to the app listing on the App Store. It is the attribution pattern Shopify allows apps on the storefront. On the complimentary free plan the icon is part of the plan and always shows; the setting does not appear.

**Remember a half-finished configuration** — off by default; turn it on if you want it. If the customer closes the configurator before finishing and comes back to the same product within 7 days, instead of the first step they see “You left a configuration half-way” with two buttons: *Continue where you left off* and *Start over*. Continuing brings back what they had chosen (at today's prices, and only the options that still exist) and lands them on the first step they still have to answer. What is **not** remembered: the prescription, the reading Rx, contact lenses and files, which they enter again. The draft lives in the customer's browser, never on our servers, and is cleared when they add to cart, start over or after 7 days. Switch it off if several customers share one device (an in-store kiosk). Below it, **“Offer to continue from N completed steps”** (2 by default): with fewer steps done nothing is kept, because redoing one costs the same as answering the prompt; raise it if you only want to rescue those who almost finished. The prompt's texts are edited under Design › Texts, and Analytics shows how many resume.

## Summary & Total

The selection list and the total line: **title**, **items** and **total** sizes; total **background** and **color**; a **shipping** line (label + value, e.g. "Free (Mainland)"); and the option to **prefix summary lines** with the step name.

## What the customer sees of their choices

Under the product in the cart, the customer sees what they configured: the steps they picked and their prescription. Something like this:

```
Frame type: Prescription glasses
Lens type: Standard thin lenses
OD: SPH -2.50 · CYL -1.25 · AX 90° · ADD +1.50
OS: SPH -3.00 · CYL 0.00 · AX — · ADD +2.00
PD: 63
Accessories: Hard case
```

Two switches let you hide this **from the customer**:

- **Hide graduation values from the customer**
- **Hide selection labels from the customer**

**Careful: "hide" means hide everywhere**

This is where almost everyone gets caught out, because it sounds like it only affects the cart.

When you turn one of these on, that data disappears from **everything the customer sees**: the cart, checkout, the order status page **and the order confirmation email**.

**You still see it** on the order detail inside your Shopify admin, and it still travels to your lab. But your customer can no longer check, at any point, which prescription they ordered.

It is all or nothing: Shopify offers no way to show a value in the email and hide it in the cart.

**Our recommendation:** leave the prescription one off. The confirmation email is your customer's only way to catch a mistake after buying, and it saves you the return.

### Keeping one step out of the order

Sometimes a step adds nothing to the order — one that only asks *how* the customer wants to give you their prescription, for instance. The prescription values already say that, so the line just makes the cart longer.

Inside each step in the editor there is a **Hide from cart and order** checkbox.

Next to it, on single-choice steps, **If this step has only one option, choose it and skip the step**: the customer never sees that screen, the option still goes to the order with its label, and Back returns to the last screen they did see. It comes switched off: if the single option is there on purpose — a price to show, a condition to read — leave it off. A step whose only option has selectable colours or an external link is always shown.

That checkbox **does not appear** on the steps carrying the prescription, nor on photo upload: an order for prescription eyewear with no prescription cannot be filled, so the app won't let you get there.

**Watch out for steps with the same name**

It is common to have several steps titled "Prescription" — the one asking for the method, the one capturing the values, the photo upload. Look at the **coloured tag** next to each step's title: it tells you the type. You can also fill in each step's **internal ID** ("method", "values", "photo") to tell them apart at a glance.

## The cart bundle

The main product + lenses/add-ons + accessories are **grouped as one bundle** under a single line, just like it reads at checkout. That relationship is kept natively (`parent_id`) for **cascade removal**, **checkout** and **order emails** — if the customer removes the main product, its add-ons go with it. See [Theme integration](https://docs.getoptical.app/en/desarrolladores/integracion/) for the technical detail.

### How it looks is your theme's call

The app applies **no styling to the cart at all**. What you see there — the indent on the child lines, the sizes, the dividers — is painted by your theme, which keeps it consistent with the rest of your store even if you switch themes.

Modern themes like Horizon nest the bundle lines on their own. If yours doesn't, or you want to fine-tune it, there are three levers in the app embed:

- **Compact the add-on lines** — makes the add-on lines smaller than the main product's, so the glasses stay the headline and the extras read as part of them. It **ships off**, and switched on it only changes sizes.
- **Which controls each line of the set shows** — three settings: **Add-ons in the cart** (with their controls, without controls, or hidden from the cart; without controls by default), **Hide the remove button of accessories** (off by default) and **Hide the quantity selector of contact lenses** (on by default). The embed ships with the controls that do no good hidden: a remove button on a lens only breaks the set, and a stepper on contact lenses only undoes what the configurator fixed. If you had the embed enabled already, you keep what you chose. See [Button & cart](https://docs.getoptical.app/en/desarrolladores/boton-y-carrito/).
- **Custom CSS** — for anything else you want to adjust. [Tested themes](https://docs.getoptical.app/en/guias/temas-probados/#any-theme-the-classes-the-bridge-leaves) lists the classes the bridge leaves on each row.

**Why it is your call now**

Hiding a control never prevented the action: anyone who wants to can still change the line. What changes since 1.5 is that **the app squares the set itself**: an add-on changed on its own goes back to its place, when the customer raises the frame the add-ons rise with it (or it goes back to 1, if you choose "Lock"), and when they remove a lens, the whole set goes (see below). With the order safe, hiding controls is only a matter of tidiness, which is why we leave it to you. The rules only reach the rows of an Optical Form set: other apps' remove buttons — warranties, shipping insurance — are left alone.

### When the customer removes a lens

A frame "configured" without its lenses is an order the lab cannot make. When the customer removes a lens, a treatment or a colour from your theme's cart, the app **removes the whole set** — the frame and the rest of its add-ons — and shows a short notice in the cart; they can configure it again whenever they like. Accessories do not count: removing a solution or a case touches nothing else. If in your store a frame can be bought on its own, **When a lens or treatment is removed**, in the app embed, has the option "Keep the frame and show a notice": the frame stays marked, with a notice under the line, and the decision is yours (the [`optical-form:cart:orphan`](https://docs.getoptical.app/en/desarrolladores/eventos/#optical-formcartorphan--a-child-line-is-missing-in-the-cart) event tells you).

### The quantity, from the cart

When the customer raises the frame's quantity in your theme's cart, the lenses and treatments multiply with it; accessories stay free; and contact lenses go back to their boxes, because those are chosen in the configurator. **Set quantity from the cart**, in the app embed, chooses between "Scale" (default) and "Lock" (always 1 per set, with a notice). Detail under [Tested themes](https://docs.getoptical.app/en/guias/temas-probados/#changing-the-quantity-from-the-cart).

---

# Theme editor settings

> The two places Optical Form puts settings in your theme, what each one does, and custom CSS.

Source: https://docs.getoptical.app/en/guias/ajustes-del-tema/
Language: en

Optical Form puts settings in **two different places** in the theme editor, and mixing them up is the number one cause of "I turned it on and nothing shows".

| | Where it is | What it controls |
|---|---|---|
| **The app embed** | Customize → **App embeds** | The engine: the cart, custom CSS. Once, for the whole store |
| **The block** | Customize → **Product** template → Add block | **The button**: how it looks and where it goes |

The short rule: **the embed makes it work, the block makes it show.** With only the embed, the product page displays nothing.

---

## The app embed (Apps)

Customize → **App embeds** → **Optical Form Drawer**.

### Cart appearance

**Compact the add-on lines in the cart.** Your theme prints each add-on as its own cart line, at the same size as the main product. This checkbox makes those lines smaller, so the glasses stay the headline and the extras read as part of them.

It **ships off**, and switched on it **only changes sizes**: it does not hide the quantity or the remove button. Verified on Horizon 4.x; on other themes it does nothing, because the markup it targets is not there.

**Why it doesn't hide the remove button**

It's tempting to hide it so nobody unbalances the order. It doesn't work: hiding a control doesn't prevent the action. And that row is shared with other apps — warranties, shipping insurance — so hiding their bin would leave your customer unable to remove a charge that isn't yours.

### Custom CSS

A text field for your own rules. They load **after** the app's and the theme's, so they win without you having to fight specificity.

What it's normally used for:

```css
/* Shrink an add-on row in the cart (Horizon 4.x) */
.cart-items__nested-line .cart-items__title { font-size: 13px; }
.cart-items__nested-line .cart-items__details { font-size: 12px; }
```

**This is YOUR theme's CSS, not the app's**

These rules target the classes your theme paints, and **those classes differ from theme to theme**. A rule written for Horizon may match nothing in Dawn. If you switch themes, revisit this field.

And you don't need it for the common case: the checkbox above already ships the Horizon recipe.

### Cart integration

**After add to cart** — what happens when the form finishes: open your theme's cart drawer, go to the cart page, or do nothing.

**"Do nothing" on Horizon**

With "do nothing" the app opens nothing, but your theme still reacts as it does to any add. Horizon opens its drawer by itself when its own **"Open cart drawer on add"** setting is on: if you don't want it to open, switch that off in the theme settings (Cart), not here.

**Keep the cart in sync** — when the customer removes the glasses, their lenses and accessories go too. **Leave it on** unless you know why you're turning it off: without it your customer can end up with loose lenses in the cart and no frame.

And the other way round: if the customer removes the lenses from your theme's cart and leaves the frame on its own, the app notices and puts a notice under that line so they see it before paying — prescription glasses without lenses can't be made. It deletes nothing and never blocks payment; if you want to go further, your theme receives an event (see [Integration](https://docs.getoptical.app/en/desarrolladores/integracion/)). While the app rearranges the lines right after an add, the pay button waits a moment.

### Advanced

Only needed if your theme isn't standard and auto-detection fails:

| | What for |
|---|---|
| **Open the drawer from the cart icon** | If your theme doesn't open its own drawer when the icon is clicked |
| **Cart count selector** (CSS) | The number over the icon, if it isn't found automatically |
| **Cart icon selector** (CSS) | The icon, if it isn't found automatically |
| **Section IDs to refresh** | The theme sections that should repaint after adding |
| **Debug mode** | Writes what it's doing to the browser console. For sending to us if something breaks |

**Leave them empty first**

They all auto-detect on most themes. Fill them in only if something fails, and one at a time — that way you know which one it was.

---

## The block (product page)

Customize → switch the view to **Product** → **Add block** → **Optical Form**.

This block draws **the button** that opens the form. Put it wherever you like, usually next to the add-to-cart button.

### Hiding the configurator on one product

At the end of the block settings, under *Advanced*: **Product tag that hides the configurator** — `optical-form-off` by default. A product carrying that tag **never shows the button**, even if it has a form assigned or belongs to an assigned collection. It is the way to leave one specific product out without touching collections or forms: a display frame, a model you only sell without lenses, a clearance item. You type the tag on the product, in your Shopify admin (*Products › the product › Tags*), exactly as written — case matters.

Prefer another word? Change it here. Empty the box and the switch is gone. In the theme editor, a product hidden by its tag tells you so in the button's slot; your customers see nothing.

### Button content

**Text** (leave empty to use the translated default), **icon** (optional, from your files), **icon position** (left or right) and **space between icon and text**.

### Colors

Background, text and border, each with **its hover version**. Six in total, so it fits your brand in both states.

### Shape & typography

**Corner radius**, **border width**, **font weight**, **letter spacing** and **text case** (normal, ALL CAPS, Title Case).

### Desktop and Mobile

The same seven settings, **separately** for each screen size:

- **Shrink to fit the text** — the button takes only the room it needs instead of the full width
- **Width**, **vertical** and **horizontal padding**
- **Font size**
- **Content alignment** — centred, or text and icon pushed to the edges
- **Icon size**

**Start with mobile**

More than half your customers buy there, and a button that looks right on desktop can feel cramped on a phone. The editor lets you switch between the two views without leaving.

### Advanced — theme integration

**Variant input selector (CSS)** — only if your theme doesn't use the standard variant input. It tells the form where to read which variant the customer picked, so the right one reaches the cart.

Leave it empty unless the form is adding the wrong variant.

---

## When something doesn't fit

1. **No button showing** → the block is missing, or the form isn't *Active + Synced*. See [Install](https://docs.getoptical.app/en/empezar/instalacion/).
2. **The cart looks odd** → try the compact checkbox first; custom CSS is the last resort.
3. **The wrong variant is added** → the block's variant selector.
4. **None of the above** → turn on **debug mode**, reproduce the problem, and send us what the console shows.

---

# Tested themes

> The Shopify themes where we have checked the Optical Form cart end to end, the CSS we keep ready for each one, and what to do if your theme is not on the list.

Source: https://docs.getoptical.app/en/guias/temas-probados/
Language: en

Optical Form adds the frame and each add-on as **separate cart lines**, grouped under the frame. How that group looks depends on the theme: each one prints its lines its own way, and not all of them know how to nest them.

These are the themes where **our team has tested the cart end to end** — adding from the form, drawer open, lines visible, readable prescription — and what to adjust in each so it looks polished.

## The table

| Theme | Versions | Status | What to do |
|---|---|---|---|
| **Horizon** | 2.0.1 · 4.1 – 4.2.0 | ✅ Our reference: add-ons nested, no controls of their own. 4.1 tested on desktop and mobile; 4.2.0 (September 2026) on desktop; 2.0.1 in a live store | Turn on **Compact the add-on lines in the cart** if you want the child lines smaller; which controls each row shows is decided in the app embed |
| **Dawn** | 15.2 – 16.0 | ✅ Tested on desktop and mobile, in the drawer and on the cart page | Nothing required: the controls are decided in the app embed; optional CSS below to nest and shrink the lines |
| **Split** (KrownThemes) | 4.4 | ✅ Tested on desktop on a live store: the cart drawer opens with the frame and its add-ons, and deleting the frame takes them along | Turn on **Compact the add-on lines in the cart** and choose under **Add-ons in the cart** whether the child rows carry controls; optional CSS below to polish |
| **Glassglow** | 9.0 | 🟠 In progress: the drawer opens and refreshes through the theme's own functions and our lines land in it; we still need to see it with the form enabled on the store. Its mini-cart shows no line properties (the configuration and prescription appear on the cart page and at checkout) and lists at most 5 lines | Write to us before enabling it |

## Horizon

No CSS needed. In **Theme › App embeds › Optical Form Drawer**, turn on **Compact the add-on lines in the cart**: Horizon already nests the set's lines under the frame, and that setting makes them smaller so the glasses stay the headline. Horizon prints a quantity stepper and a remove button on every row, children included: if you would rather the add-ons did not show them, that is the **Add-ons in the cart** setting on the same app embed. See [Changing the quantity from the cart](#changing-the-quantity-from-the-cart).

Two things worth knowing about **Horizon 4.2.0**:

- If you update from the Theme Store, the new theme arrives **without the "Optical Form" block** on the product template (the app embed is kept, because it is an app setting). Place it again under **Customize › Product template › Add block › Apps**.
- Its **"Add to cart" auto-opens drawer** setting (Theme settings › Cart) ships off. Off, Optical Form opens the cart drawer once the theme has painted the lines; on, the theme opens it at once, and the lines travel in the same request as the add, so it opens filled either way.

## Dawn 15.x

Dawn prints every add-on as a line just like the frame, with its own quantity stepper and remove button. Which controls each row shows is decided in the app embed (**Add-ons in the cart**, **Hide the remove button of accessories**, **Hide the quantity selector of contact lenses**), and it works the same in the drawer and on the cart page. If you also want the child lines nested and smaller, like Horizon:

1. Go to **Online Store › Themes › Customize › App embeds › Optical Form Drawer**.
2. Paste this into **Custom CSS** and save:

```css
/* Optical Form · Dawn 15.x/16.x — add-on lines nested and shrunk under the frame, like Horizon */
.cart-item.ofd-bundle-child td { padding-top: .8rem; padding-bottom: .8rem; border-top: 0; }
.cart-item.ofd-bundle-child .cart-item__media { padding-left: 3.2rem; }
.cart-item.ofd-bundle-child .cart-item__image-container { width: 100%; max-width: 5.2rem; }
.cart-item.ofd-bundle-child .cart-item__name { font-size: 1.3rem; line-height: 1.35; }
.cart-item.ofd-bundle-child .product-option,
.cart-item.ofd-bundle-child .cart-item__totals .price { font-size: 1.2rem; }
.cart-item.ofd-bundle-child .cart-item__quantity { padding-top: 0; }
```

**If you had pasted the earlier CSS**

The old recipe hid the frame's stepper and the add-ons' controls with CSS. That is no longer needed and those rules are best removed: the frame's stepper now does something (it multiplies the add-ons, or goes back to 1 under "Lock"), and the children's controls are decided in the app embed. The size rules above still apply.

## Split (KrownThemes)

Split has its own cart drawer and the app recognises it on its own: no selectors to set. Two things:

1. Under **Theme › App embeds › Optical Form Drawer**, turn on **Compact the add-on lines in the cart** (child lines indented under the frame) and, if you do not want the add-ons to show a quantity stepper or the "Remove" link, set **Add-ons in the cart** to "Visible without controls". The frame's stepper stays: it multiplies the add-ons, or goes back to 1 if you choose "Lock" under **Set quantity from the cart**. The frame keeps "Remove", and deleting it takes the lenses along.
2. If you want the child lines smaller and indented under the frame, paste this into the same app embed's **Custom CSS**:

```css
/* Optical Form · Split — compact add-ons under the frame (drawer and cart page) */
#AjaxCartForm .cart-item.ofd-bundle-child { padding-left: 24px !important; margin-top: -8px !important; }
#AjaxCartForm .cart-item.ofd-bundle-child .thumbnail { width: 56px !important; flex: 0 0 56px !important; }
#AjaxCartForm .cart-item.ofd-bundle-child .item-title { font-size: 13px !important; line-height: 1.35 !important; }
#AjaxCartForm .cart-item.ofd-bundle-child .item-price { font-size: 12px !important; }
#AjaxCartForm .cart-item.ofd-bundle-child .actions { display: none !important; }
```

Split prints **every** line property in the cart, including the technical ones that start with `_` (it strips the underscore), so under the frame and under each add-on you will see lines like `ofd_type: main`. Two ways to remove them:

- **The clean one, in the theme**: in `snippets/cart-form.liquid`, the condition that decides which property is printed (`{%- if p.last != blank and p_first_char != '_p_' -%}`) becomes `{%- if p.last != blank and p_first_char != '_p_' and p.first contains '_ofd_' == false -%}`. Works for any order and any form setting.
- **CSS only**, pasted under the block above. Valid as long as **Merge the selections into one line** (Design › Cart lines) is on: that line comes first and the technical ones sit second, third and last. If you turn merging off, change the frame's first two rules to `span:nth-child(-n+2)`.

```css
/* Technical properties (ofd_*): all of them on add-ons; the 2nd, 3rd and last on the frame */
#AjaxCartForm .cart-item.ofd-bundle-child .margin-top-xs { display: none !important; }
#AjaxCartForm .cart-item.ofd-bundle-parent .margin-top-xs > span:nth-child(2),
#AjaxCartForm .cart-item.ofd-bundle-parent .margin-top-xs > span:nth-child(3),
#AjaxCartForm .cart-item.ofd-bundle-parent .margin-top-xs > span:last-child { display: none !important; }
```

## Any theme: the classes the bridge leaves

On every theme, the cart bridge marks each row of a set with its **role**: `ofd-bundle-parent` on the frame (plus `ofd-set-fixed` when it is a pair of contact lenses, whose quantity the configurator fixes), `ofd-bundle-child` on every child, plus `ofd-bundle-addon` (lenses and treatments) or `ofd-bundle-accessory` (solutions, cases). And inside each row it marks the controls it finds: `ofd-ctl-qty` on the quantity stepper (the number with its buttons) and `ofd-ctl-remove` on the remove control. These are the classes the app embed's settings use on the measured themes, and the ones you can use on any other, pasted into **Custom CSS**:

```css
/* Optical Form · any theme — by the role of each row of the set */
.ofd-bundle-addon .ofd-ctl-qty,
.ofd-bundle-addon .ofd-ctl-remove { display: none !important; }   /* add-ons without controls */
.ofd-bundle-accessory .ofd-ctl-remove { display: none !important; } /* accessories without a remove button */
.ofd-set-fixed .ofd-ctl-qty { display: none !important; }           /* contact lenses without a stepper */
/* or, instead of the first rule, add-ons hidden altogether: */
/* .ofd-bundle-addon { display: none !important; } */
```

The control marks are a heuristic (it looks for the number field with its "+"/"−" buttons and for the remove button or link by its label), but a fenced one: it only ever looks inside the rows of an Optical Form set, so it never touches another cart line or the rest of the page. If it misses on your theme, write to us with the name and version and we will measure it.

## Changing the quantity from the cart

A configured frame and its add-ons are **one set**. When the customer raises the frame's quantity in your theme's cart — drawer or page — the app multiplies the lenses and treatments with it (two lenses per frame, one treatment per frame…), in a single request and without reopening the drawer. If instead they change an add-on on its own, it goes back to its place. Accessories stay free. And **contact lenses are not scaled**: their boxes per eye are chosen in the configurator, and any change in the cart goes back to them with the notice "The boxes per eye are chosen in the configurator".

If you would rather a configured frame always be one unit, set **Set quantity from the cart** to "Lock": it goes back to 1 with the notice "The quantities of this set go together. For another identical frame, configure it again". Both notices are translated. All of this is measured on Horizon 2.x to 4.2, Dawn 15 and 16 and Split, with and without automatic discounts (a buy-one-get-one splits the frame into several lines and the app adds them up).

## What your customer sees in any of these themes

- The frame with its photo, its price and the chosen configuration.
- The **labelled prescription**, with the same field names as the form: `OD: SPH -2.25 · CYL -0.75 · AX 90°`, `OS: …`, `PD: 63`.
- The add-ons underneath, each with its price and quantity — or without controls, or hidden, as you choose in the app embed.

The technical properties that go to the lab (they start with `_`) are not shown by any Shopify theme: not in the cart, not at checkout, not in the email.

## Your theme is not on the list

The form and the charging work the same on any theme: the app embed's automatic settings detect the cart of most of them. What we can't guarantee without seeing it is **the finish** of the drawer — add-ons nested and polished as in Horizon — because every theme prints its lines with its own code.

If you want that finish on a theme that isn't here, write to support@getoptical.app with the theme's name and version. We'll usually ask for **collaborator access** to the store (*Themes* permission) or, at the very least, a preview link of the theme with the form enabled on a product. With that we adjust the cart, hand you the CSS ready to paste, and the theme joins this table.

---

# The product button

> How to give the button that opens the configurator the same look as your theme's own buttons, on desktop and on mobile.

Source: https://docs.getoptical.app/en/guias/boton-del-producto/
Language: en

The button that opens the configurator lives on the product page, so it needs to look like the rest of your shop's buttons. You configure it in the **theme editor**, not inside the app.

## Where to configure it

1. In your Shopify admin, go to **Online Store → Themes → Customize**.
2. Open a product page.
3. Click the **Optical Form** block.

Everything you see there applies **to that block only**, and affects every product using that product template.

## The button inherits nothing

This one matters, and it runs against what you'd expect: **the button takes its colours from nowhere**. Not from your theme, not from the form's *Design* tab.

That is deliberate. Shopify themes each define their buttons differently, and there is no reliable way to guess. Rather than get it half right, the app lets you decide all of it.

Out of the box it is a **very dark grey button with white text** — neutral enough to sit quietly in almost any shop until you adjust it.

**The quick way to get it right**

Don't try to guess your theme's colours. Go to a product page on your shop, right-click your **Add to cart** button and choose *Inspect*. The exact colour is right there. Copy it and paste it here.

If that sounds like gibberish, there is another way: take a screenshot of your theme's button and use any colour picker (Shopify's own colour selector has one) to read the shade.

## Content

- **Button text** — what it says. Leave it empty and the app's translated text is used, which adapts to each customer's language on its own. **Type something here and that exact text shows in every language.**
- **Icon (optional)** — an image from your **Files** library. A square PNG with a transparent background, around 128×128, works best. Leave it empty for a text-only button.
- **Icon position** — before or after the text. Only shows when there's an icon.
- **Space between icon and text** — 0 to 32 px. Ignored when the content alignment pushes the pieces apart.

## Colours

Six colours: **background**, **text** and **border**, each with its own **on hover** version.

The border only shows if you also give it a width greater than zero, further down. If you leave the border colour empty, no border shows even with a width.

## Shape & typography

These are **shared between desktop and mobile**, because they rarely need to differ:

- **Corner radius** — from 0 (square) to 60 (pill).
- **Border width** — 0 means no border.
- **Font weight**, **letter spacing** and **text case**.

## Desktop and mobile, separately

What genuinely changes between screens has its own set:

| Setting | What it does |
|---|---|
| **Shrink to fit the text** | The button takes only as much width as its text needs, instead of a fixed width. Usual on desktop |
| **Width** | Percentage of the space available. On mobile, almost always 100% |
| **Vertical and horizontal padding** | The air between the text and the button's edge. This is what gives it its size |
| **Font size** | |
| **Content alignment** | Where the icon and the text sit inside the button: centered, left, right, or pushed apart |
| **Icon size** | 10 to 48 px. Only shows when there's an icon |

The **mobile** set applies on screens narrower than 750 pixels, Shopify's standard cut-off.

**How to preview mobile**

In the theme editor, top left, there are screen and mobile icons. Click the mobile one and you'll see how it looks without leaving the editor.

## Where the button sits relative to your theme's

By default the button shows wherever you put the block in the editor: above or below your theme's "Buy buttons" block, on its own line. If you want it next to "Add to cart", use the block's **Position** setting under **Theme integration & placement**:

- **Where the block is placed**: as before.
- **Above the theme's add to cart** / **Below the theme's add to cart**: right above or right below the line your theme's button sits on. "Below" lands between that button and the accelerated checkout buttons (Shop Pay, PayPal).
- **Side by side, left / right**: both buttons on the same line, half and half, same height. **Gap** is the space to the theme's button, in any position, and **Stack on mobile** puts them one under the other at full width on narrow screens, because half a width on a phone breaks the label.

Nothing to change in the theme: the app finds the "Add to cart" button on its own in the themes we have tested. If it can't find yours, the button stays where the block is, and you can point it at your button with a CSS selector under **Add to cart selector**, or write to us. Side by side, the button takes its half's width; colours, text, icon and typography stay the block's own.

## Advanced settings

The **Variant input selector** field is for developers and is **almost never needed**: only for unusual themes where the app can't detect which variant the customer picked. Leave it empty unless support tells you otherwise.

## When the frame is sold out

The button follows the variant like your theme's own buy button. If the variant the customer has selected cannot be sold, the button shows **disabled with the text "Sold out"**; switch to a colour with stock and it comes back without a reload. In the same block, under **Advanced settings**, the **When the frame is sold out** setting lets you choose between that disabled button and **hiding it** altogether. The word "Sold out" is edited under **Design › Texts** of each form.

Even if a customer managed to open the configurator on a sold-out frame, "Add" would not send it to the cart: it would say "The frame X is sold out. Please choose another frame".

## Where is all the other wording?

- The app's **admin language**: under **Settings** inside the app. See [Languages & wording](https://docs.getoptical.app/en/guias/traducciones/).
- The **form wording** your customer reads: inside each step, in the form editor.
- The **configurator's colours** (the panel that slides open): in each form's **Design** tab. See [Design & cart](https://docs.getoptical.app/en/guias/diseno-y-carrito/).

---

# Icons for your options

> A pack of 28 icons, free and cleared for commercial use, so your whole configurator looks like one thing.

Source: https://docs.getoptical.app/en/guias/iconos/
Language: en

Every option in your form can carry an image. Pull one from here and one from there and
the configurator looks patched together — and shoppers notice that, even when they
couldn't tell you why.

So there's a pack of our own: **28 icons**, drawn for GetOptical and **free to use on
your store**, modified or not. They cover an optician's catalogue end to end: the type
of glasses, the index, a progressive's viewing area, the treatments and the add-ons.

<p><a href="https://www.getoptical.app/downloads/getoptical-lens-icons.zip"><strong>Download the pack (ZIP, 24 KB)</strong></a></p>

## What's in it

**What the customer is buying**

| Icon | For |
|---|---|
| `glasses-prescription` | Prescription / single-vision |
| `glasses-progressive` | Progressive |
| `glasses-reading` | Reading glasses |
| `glasses-plano` | Non-prescription |
| `glasses-sun` | Sunglasses |
| `contact-lenses` | Contact lenses |

**Lens index** — the profile in accent marks which one. Further right, thicker.

`index-150` · `index-160` · `index-167` · `index-174`

**Viewing area, for progressives** — the clear corridor widens as you go up the range.

`corridor-standard` · `corridor-wide` · `corridor-premium`

**Treatments**

| Icon | For |
|---|---|
| `lens-standard` | Standard lens |
| `lens-anti-reflective` | Anti-reflective |
| `lens-blue-light` | Blue-light blocking |
| `lens-photochromic` | Photochromic |
| `lens-polarised` | Polarised |
| `lens-tint` | Colour tint |
| `lens-driving` | Driving |
| `lens-mirror` | Mirror coating |
| `lens-water-repellent` | Water-repellent / hydrophobic |
| `lens-scratch-resistant` | Scratch-resistant |
| `lens-anti-fog` | Anti-fog |
| `lens-uv` | UV filter |

**Add-ons**

| Icon | For |
|---|---|
| `addon-case` | Case |
| `addon-solution` | Cleaning solution |
| `addon-cloth` | Cleaning cloth |

They're **SVG**, so they stay sharp at any size and weigh about 500 bytes each.

**Two sets in the box**

The main folder is for **light** backgrounds. The `on-dark/` folder has the same
icons with the outline lifted, for dark configurators. Pick the set that matches your
design: on the wrong background the outline disappears. The **Sunglasses · Dark** form
template and the **Dark** design preset use the `on-dark/` set.

## How to use them

1. In your Shopify admin, go to **Content → Files** and upload the ones you need.
2. Copy each file's URL.
3. In your form, open the option and paste it into **Option image**.

**Upload them to your store — don't link to ours**

Linking straight to `getoptical.app` is tempting. It works today, but if we ever
reorganise that folder your product pages lose their images. With the files in your own
store, that can't happen to you.

## If you want to add your own

The pack follows a simple grammar, and sticking to it is what makes the icons look like
one set:

- **The lens is always the same ellipse** — `cx 72, cy 72, rx 45, ry 36`, stroke `8`, on
  a `144 × 144` canvas.
- **Inside goes the concept**, and **the accent colour marks the subject** of the icon.
- **Grey is for the secondary part**, never for the subject.
- The index and viewing-area icons vary a **shape**, not a label: which profile sits in
  accent, or how wide the corridor gets. Set them far enough apart that the difference
  survives at 40 px, which is the size they're actually used at.
- **The add-ons carry no ellipse.** The ellipse means "this is a lens", and a case isn't
  one.

Palette: outline `#1F2A28` · accent `#0E6E63` · grey `#7E8E8B`.

## What you can do with them

You may **use, modify, recolour and publish** them on your storefront and in your
marketing, including on stores you build for your own clients. No attribution, no fee.

The one thing you can't do is **resell or redistribute them as an icon pack**, on their
own or as the substance of another product.

**About brand names**

The icons are deliberately generic and carry no third-party marks. There's no
*Transitions®* icon, because that's a registered trademark of Transitions Optical. Label
your own options with the brand names you're entitled to use as the seller of those
products — the photochromic icon works just as well.

---

# Languages & wording

> Where every text your customer sees comes from, which one wins, and how to change a label without breaking your other languages.

Source: https://docs.getoptical.app/en/guias/traducciones/
Language: en

This is the part that raises the most questions, so let's take it slowly. No technical knowledge needed.

## First: two things people mix up

| | What it is | Who sees it |
|---|---|---|
| **Admin language** | The language *this* app is shown in while you work | Only you and your staff |
| **Form wording** | The words that appear in the form on your storefront | Your customers |

They are independent. You can run the admin in English and sell in Spanish, or the other way round.

### Admin language

Under **Settings → Language** you choose *Automatic*, *English* or *Spanish*.

It is saved **on your store** and applied straight away, with no save button. It's a store preference, not a per-person one: your whole team sees the admin in the language you pick here. On *Automatic* the app follows your store's primary language.

## Form wording: where it comes from

Here is the important bit. Every text your customer sees can come from **three different places**, and when two of them disagree, one specific place wins.

Think of it as a ladder. Each rung overrides the one below:

```
4. Per-language translation (language selector)  ← always wins
3. What you type in the step's boxes             ← only if you change it
2. Your store's language (English, Spanish…)     ← the normal case
1. The factory wording, in English               ← the floor
```

### 1. Factory wording

The app ships with all its wording written in English. That is the floor: if nothing overrides it, that is what shows.

### 2. Your store's language

The app comes translated. If your store is in Spanish, your customer sees the form in Spanish automatically — you don't have to do anything.

This already covers most shops: **you don't need to touch anything below.**

### 3. The text boxes inside each step

Each step has boxes where you can rewrite its labels: the titles for each eye, the field names, the error messages…

As long as you leave a box alone, it shows up **empty, with the factory wording in grey** — the same text your customer sees, in your store's language. Open a prescription step in a Spanish store and the sphere box shows `ESF:` in grey; in an English store, `SPH:`. That grey is not a value: it is what gets shown if you type nothing.

Only when you **type something** into the box does your wording take over. Type `Sphere:` and your customers will see `Sphere:`.

**If you see English text typed into a box**

Forms saved before August 2026 carried the English factory wording typed inside every box (`SPH:`, `Right eye (OD)`…). The app already tells the difference: text identical to the factory wording counts as *untouched*, so your customer keeps seeing the store's language, and when you open the step today those boxes show up empty with the grey. If one still shows English typed in, somebody changed it on purpose.

**Watch out for one consequence:** whatever you type there applies to **every language** in your store. Type `Sphere:` and a Spanish customer sees `Sphere:` too.

### 4. The language selector

If you sell in several languages and want different wording in each, use the **language selector** next to the *Steps* heading in the form editor.

Pick a language, write the wording for it, switch to another and write its own. Each language keeps its own set.

This overrides everything else, always.

### 5. The interface texts

Some words belong to no step but to the form itself: **Next**, **Add to cart**, **Summary**, **Total**, **Included**, "Choose a colour to continue", the cart error messages… They ship translated with the app and, until now, could not be changed.

From **Design › Interface texts** they can. The **product-page button text** (the one that opens the form) lives there too, in the first group. Each box shows in grey what your customers see today in the chosen language, you type over it to say it your way ("Order my glasses" instead of "Add to cart", "Continue" instead of "Next") and empty the box to go back. If you sell in several languages, pick the language at the top of the section and write its own: each language keeps its own set.

Two things to respect: the placeholders in braces — `{price}`, `{label}` — are where the app puts the amount or the step name and must stay; and some texts are read only by screen readers (Close, Back, the help icon), so change those only if you know what a screen reader does.

## How do I…

**…rename a field across all languages**
Type the new wording into the step's box. Good for single-language shops, or when you want the same term everywhere.

**…use different wording per language**
Use the language selector in the editor. It is the only way to give each language its own.

**…go back to the original wording**
Empty the box: the grey factory wording comes back, and your customer sees the store's language again.

**…keep a field in English inside a Spanish store**
Type the English term into the box (for instance `SPH:` instead of the grey `ESF:`). If only Spanish-speaking customers should see it and not your other languages, use the language selector, pick *Spanish*, and type it there.

## If you bring a form from another store

Every form has a **base language**: the language of the store where it was created. It's the one the selector shows marked *— Base*.

When you import a form into a store whose primary language is different, the app **switches the base to your store's language** and keeps the original language as one more translation. No text is lost and there's nothing for you to do.

If some field had no translation into your language, it stays as it was instead of going blank: seeing the text in another language beats seeing nothing.

**How to tell which language you're editing**

The selector next to the *Steps* heading always tells you which one is the base. If it says **English — Base**, whatever you type in the boxes is the English copy; for any other language, switch the selector first.

More detail in [Copying a form to another store](https://docs.getoptical.app/en/guias/copiar-formulario/).

## Colors and help texts translate too

Everything you write inside an option translates like its label, with the same language selector: the **name of each color**, the **title, description and help of each color group**, and the **help text** behind the "?" next to the title. What you don't write — "Choose a color to continue", the "From" before a price, "Included" — ships translated; and if you rewrite it under **Design**, your wording applies in every language.

## Wording that isn't in the steps

The form's general buttons — *Next*, *Previous*, *Add to cart*, *Total*, the error messages — ship translated with the app and follow your store's language. Nothing to configure.

**After changing wording, sync**

Saving in the editor does **not** update your storefront yet. Press **Sync now** and wait for the status to read *Synced*. Until then your customers still see the previous version.

---

# Sync & backups

> Publish your forms to Shopify via metaobjects and back them up as JSON.

Source: https://docs.getoptical.app/en/guias/sincronizacion/
Language: en

## Save ≠ Publish

Editing a form in the app and clicking **Save** stores the changes, but does **not** publish them to the store. To reach the storefront you must **Sync**.

Each form is published as a **Shopify metaobject**. The theme extension reads that metaobject to render the drawer.

## Sync with Shopify

1. Save the form.
2. Click **Force Sync** (the hint on the Settings tab calls it "Sync to Shopify").
3. The sync runs **in the background**; reload to see the status.

On the form's **Settings** tab you'll see the status: **Synced**, **Not synced** or **Sync failed**, and the last sync date.

**If it says "Sync failed"**

That form **never published**, so your store is still showing the previous version — or nothing at all, if this was the first time you published it.

Open it and hit **Force Sync**. It usually takes a few seconds and that clears it in most cases.

Nothing is lost: your steps, wording and settings are saved. If it fails again, write to **[support@getoptical.app](mailto:support@getoptical.app)** and we'll look into it.

**Remember to sync after every change**

If you change steps, prices or design and only save, the storefront keeps showing the previous version until you sync.

## Form status

A form only appears on the store if it's **Active** *and* **Synced**, and its product has the form assigned with the [app embed](https://docs.getoptical.app/en/empezar/instalacion/) enabled.

## Backup & restore (JSON)

- **Export form as JSON** (Settings tab) — downloads the whole form config. Use it to back up or to **copy the form to another store**.
- **Import from JSON** (dashboard) — creates a new form from an exported file.

Steps, wording, translations, design and your optical software codes travel intact. **Add-ons don't**, because they're linked to products in one specific store: see [Copying a form to another store](https://docs.getoptical.app/en/guias/copiar-formulario/).

No data is deleted when you change plans: your forms, their steps and their translations stay exactly where they are.

**What does switch off if the plan lapses**

Your data is untouched, but the configurator **stops rendering on your store**, even though the form still shows as **Active** inside the app. This isn't a sync failure — it's the plan.

Bring the payment up to date and everything comes back exactly as you left it: right away if you sync the form yourself, or on its own with the daily check.

---

# Copying a form to another store

> What travels inside the JSON file, what can't travel no matter what, and what to do once it lands.

Source: https://docs.getoptical.app/en/guias/copiar-formulario/
Language: en

You can move a whole form from one store to another, or keep it as a backup. It's done with a file — no code involved.

This page explains **what gets copied and what doesn't**, because one part can't travel, and knowing that up front saves you a confusing afternoon.

## How to do it

1. In the source store, open the form → **Settings** tab → **Export form as JSON**. A file downloads.
2. In the destination store, go to the main dashboard → **Import from JSON** → pick that file.

Done. A new form appears with the same name and the word *(imported)* at the end.

**It always arrives as a draft**

An imported form comes in as **Draft**, never active. That's deliberate: you get to review it before a customer ever sees it.

## What travels and what doesn't

| | Travels? |
|---|---|
| The steps, in order | ✅ Yes |
| Every option, with its text and descriptions | ✅ Yes |
| Translations into other languages | ✅ Yes |
| The jumps between steps (conditional logic) | ✅ Yes |
| Prescription ranges and labels | ✅ Yes |
| Colors, sizes and design settings | ✅ Yes |
| Your optical software (ERP) codes | ✅ Yes |
| **Add-ons and accessory products** | ⚠️ Only if they exist in the destination store |
| Assignment to products and collections | ❌ No |

## What happens to add-ons

An add-on isn't a piece of text: it's **a specific product in your store**. Under the hood it's stored as an ID number that Shopify assigns to that product **in that store and nowhere else**.

Those numbers are never the same across stores. Ever. Even if you create a product with the same name, the same price and the same photo, its number will be different.

So on import, the app **checks each one** to see whether it exists here:

- **Copying within the same store** (duplicating a form, restoring a backup): the numbers are valid, so **the add-ons come through intact**.
- **Copying to another store**: the ones that don't exist here **are removed**, and the notice at the end tells you how many links were dropped. Your steps and options stay exactly as they were — the only thing lost is the link to the product.

**Why they're removed rather than left "just in case"**

A product number from another store doesn't fail gently. Shopify rejects the **whole** add-to-cart request, so your customer ends up with **nothing** — not even the frame. And if the add-on sits on an option, you wouldn't see it coming: anyone who picked that option would simply stop being able to buy.

**Create the products before importing**

If you already know which add-ons you'll want (lens types, treatments, fitting…), create them in the destination store **before** importing. Then you can link them in one pass instead of going back and forth.

## Your optical software codes do travel

If you have filled in the **Integrations** tab with the codes your practice management software (Gesvisión or another) uses to identify each lens and each treatment, those codes **travel inside the file**, just like the text does.

They are the exception to the add-on rule: an ERP code isn't a number Shopify hands out, it's a label of your own, so it means the same thing in any store.

**If you imported before August 2026, import again**

Earlier versions of the app dropped those codes along the way: the form arrived complete but **with no integration**, and orders went out without the reference your software expects. If that happened to you, export again from the source store and re-import.

What the app will **not** do is invent them. If the file carries no codes, they arrive empty and you fill them in: they are yours and your supplier's, and nobody else can guess them.

## If you see a "products no longer exist" warning

It can happen with forms imported from older versions, or if someone deleted a Shopify product that was linked.

It's an orange notice at the top of the form, with a **Remove deleted references** button.

- If the products it lists **really are gone** from your store, click the button: it cleans up those references and leaves the form healthy.
- If they look familiar and **you think they do exist**, don't click anything — contact us. The button removes the add-ons from your options, and if the warning were wrong you'd lose that setup.

## The language adjusts itself

Every form has a "base" language, which is the language of the store where it was created. If you copy a form from a Spanish store to an English one, the app **switches the base to the destination store's language** during the import, and keeps the original language as a translation.

No text is lost and there's nothing for you to do. If some field has no translation for the destination language, that field is left as it was instead of going blank.

To understand where each piece of text comes from, see [Languages & text](https://docs.getoptical.app/en/guias/traducciones/).

## The sample forms

**When you install the app you already have four**, in draft, without doing anything:

- **Prescription glasses · full screen** — an optician's 11 steps as a split screen, with sample treatment colours (no product behind them: swap them for your tints).
- **Prescription glasses** — the same 11 steps in a side panel: glasses type, lens thickness, reading power, treatments, how you give us your prescription, the prescription, the summary, the upload and the accessories.
- **Sunglasses · dark** — sun only or prescription, tint, polarization and accessories, with the Dark design preset.
- **Contact lenses** — the 3 steps of a contact-lens sale: lens pack, prescription per eye and care products.

All four arrive **in your store's language** and in **draft**, so nothing shows on any product page until you activate one.

**They ship without add-ons on purpose**, for the reason you just read. Open them, walk through the steps, and link your own products on the options where you want to charge extra.

## After importing, in this order

1. **Review the steps** and adjust the wording to how you talk about your lenses.
2. **Link your add-ons** on the options that should carry a price.
3. **Assign the form** to your products or collections, in the *Products* tab.
4. Set the status to **Active**.
5. Click **Sync now** and wait until it says *Synced*.

**Not synced means not visible**

Saving saves, but it doesn't publish. Until you sync, your customers won't see the new form. Same every time you change something.

---

# Reading the analytics

> What each figure in the Analytics tab means, what the "this is where they stop" signal is, and what to change in your form depending on the step that loses customers.

Source: https://docs.getoptical.app/en/guias/analitica/
Language: en

The **Analytics** tab in the admin tells you what your customers do with the configurator: how many open it, how many reach the cart and where the rest stop. This guide explains each figure and, above all, what to do with it.

## Where it is and which period it looks at

In the app menu, **Analytics**. At the top you pick the period: last 7, 30 or 90 days. Every figure is compared with the previous period of the same length; that is the small number with the arrow. The figures are recalculated at most every ten minutes: if you have just tried the configurator yourself, give it that long before looking for yourself in the funnel.

## The four figures at the top

- **Opened it.** Distinct customers who opened the configurator. A customer who opens it three times counts once.
- **Reached the cart.** Customers who finished and added their order.
- **Conversion.** Of those who open, how many finish. In the stores we measure it sits between 20 and 30 percent; below 20 there is almost always a step losing people, and the funnel tells you which.
- **Typical time.** How long a customer takes to complete it, as a median: half take less, half take more. One to two minutes is normal with five steps.

Below, and only when it has happened, a line in red: **Add-to-cart errors: N**, broken down by cause — frame sold out, add-on unavailable, stock limit in cart, store busy. Each one is a customer who finished the form and couldn't buy. A repeated "add-on unavailable" is a treatment or accessory out of stock or in draft: check it in the editor with **Check prices**.

## Day by day

The chart shows openings and cart arrivals per day, with the previous period as a dashed line. It is for seeing whether a change in the form or a campaign moved anything, not for reading a single day: with few visits any day looks like a trend.

## Where they stop

One funnel per form. Each bar is a step: how many customers reached it and, in red, how many closed the configurator right there. What matters is not the raw red but the proportion: a step reached by 10 that loses 5 is worse than one reached by 500 that loses 20.

Steps are named with the label you gave them in the editor. A step you deleted keeps showing while it has data, marked as deleted.

## The signal: "this is where they stop"

Above each form's funnel, the app points at **the step that loses the most** in proportion to those who reach it, and tells you what to change. To avoid pointing at noise, it only appears once **at least 20 customers** have reached the step and **25 percent or more** of them leave. With less data you will see "not enough data yet" and how many sessions you have so far; with enough data and no step above the threshold, "no step loses more than 25 percent".

The signal comes with two buttons: **Edit the form**, which opens that form in the editor, and **How to improve it**, which brings you here.

The same signal, the strongest across all your forms, also shows on the app **Home**, below your forms. You can dismiss it; if the signal moves to another step some other week, it comes back.

## What to change depending on the step that loses

**A choice step** (lens type, index, treatment, colour). This is where most people leave, and almost always for the same reason: they have to decide something they do not master, and they see the price. Keep three or four options and flag the one you recommend with the “Recommended” label (the **Choose label** button on the option; the customer sees the pill next to the name). Add help text to the confusing ones, give them an icon from the pack and show the price as a supplement over the previous choice, not as a new total. See [Build a form](https://docs.getoptical.app/en/guias/crear-formulario/), [Icons](https://docs.getoptical.app/en/guias/iconos/) and [Pricing and charging](https://docs.getoptical.app/en/guias/precios-y-cobro/).

**The prescription step** (glasses, reading or contact lenses). Whoever does not have the prescription at hand leaves. Make ADD and pupillary distance optional, put a sample prescription in the help text and offer uploading a photo of the prescription as an alternative with a file upload step. See [Prescription capture](https://docs.getoptical.app/en/guias/graduacion/) and [File upload](https://docs.getoptical.app/en/guias/subir-receta/).

**The prescription summary.** This is where the customer first sees everything together, and the total. Check that every line has a price that makes sense and that the button says exactly what happens next.

**The file upload.** Accept image and PDF, say which formats and size are fine, and allow skipping it: if it is required and the customer does not have the prescription at hand, they leave.

**Accessories and extras.** They are optional: do not pre-select them and show each one's supplement. If people leave right here, the price is the surprise. See [Add-ons & accessories](https://docs.getoptical.app/en/guias/accesorios-y-addons/).

**A text field.** A required free-text field slows people down. Make it optional or turn the question into options.

After every change, wait 30 days and look at the same funnel again. It is the only way to know whether the change worked.

## What they choose most

The table at the bottom counts, from finished orders only, which options were chosen most often. It answers "is the expensive option worth it?" and "does anyone pick this?". Prescription steps never appear.

## What is not measured

These figures are anonymous. The app stores no prescription, no file and no customer data, and the figures never leave your store: nobody else sees them. Data is kept for 195 days and then deleted on its own; the funnel of a period that no longer exists cannot be recovered.

If you want to combine these figures with your own analytics or your chat, the configurator emits browser events for that: [What to do with each event](https://docs.getoptical.app/en/desarrolladores/eventos/).

---

# When something isn't working

> Find your symptom, run the checks in order, stop at the first one that fails. No jargon.

Source: https://docs.getoptical.app/en/guias/cuando-algo-no-funciona/
Language: en

Find **what you're seeing** below and work through the checks **in the order given**. They're sorted from most to least common, so stop as soon as one fails — that's your answer.

---

## I can't see the button on the product page

The most common case, and it's almost always one of the five conditions that all have to be true at once.

**1. Is the Setup guide at 6/6?**
Open it on the app's home screen. If any step is outstanding, there's your answer — do that step and come back.

**2. Is the form Active *and* Synced?**
Form settings. You need **both**. *Active* but *Not synced* means your changes haven't reached the store yet: hit **Sync now** and wait for the green badge.

**3. Is this product assigned to the form?**
The form's **Products** tab. A perfect form that isn't assigned shows up nowhere. If you assigned it by **collection**, check the product really is in that collection and that the collection is **published to the Online Store**: collections that are not do not show the form ([Products and collections](https://docs.getoptical.app/en/guias/productos-y-colecciones/)).

**4. Is the block on the template this product uses?**
This is the one that catches people out. If you have several product templates, the block has to be added **to each one**. Check the product's right sidebar, under **Theme template**, to see which it uses — then make sure the block is on that one.

**5. Are you looking at the published theme?**
Theme settings aren't shared between themes. If you added the block to a draft, it isn't on the live one.

**Shortcut**

Switching themes **wipes** the embed and the block, because they're theme settings. If the button vanished right after you changed or updated your theme, that's why — the Setup guide will flag it.

---

## I see two identical buttons

The block got added twice. It happens easily: the link in the Setup guide **already drops the block in** for you, so adding another by hand leaves two.

In the theme editor, on the product template, delete the spare and save.

---

## The button shows but clicking does nothing

Almost always the **embed is switched off**. A block draws the button, but the embed loads the form itself: without it you get a button and no engine.

Go to the Setup guide and check the **"Enable the app embed"** step. If that's green and it still won't open, write to us with your theme name and version.

---

## I pick a variant and the cart gets a different one

For example, you pick black and blue arrives.

The form reads the variant when it opens **and again when adding to cart**, so changing variant with the form open is safe.

If it still gets it wrong, your theme announces the variant in an unusual way. There's a no-code fix: the block settings have a field to point it at the right place. **Send us the product URL** and we'll tell you exactly what to put there.

---

## I add to cart and the cart doesn't notice

The item **has** been added — check by opening the cart — but the screen doesn't update on its own.

1. Reload the page and look at the cart. If the item's there, this is a display refresh issue, not a selling one.
2. In the embed settings, check **"Keep the cart in sync"** is on.
3. **Your theme is Dawn and the drawer opens empty or blank**, even though closing and reopening it (or reloading) shows the lines: that was a bug on our side, now fixed. Make sure you're on the latest version of the app (themes load it automatically — reloading the store is enough) and, if it persists, write to us with your theme's name and version.
4. If your theme is unusual, the embed's **Advanced** section has fields to point it at your cart. Write to us before touching them — they're normally unnecessary.

---

## Treatments appear as separate cart lines

They should sit **underneath the frame**, indented, as part of the set.

When they show as independent lines, your theme renders the cart in a way the app doesn't recognise. **It doesn't affect the sale**: prices, the order and checkout are all correct — it just looks worse.

Write to us with your theme name. It's usually a few lines of **Custom CSS**.

---

## Customers can change the quantity of a treatment

**That's on purpose, not a fault.** The app places treatment lines under the frame, but it **does not hide their quantity stepper or remove button**.

The reason: hiding a button never prevents the action — anyone can still change that line through the cart API — and that same row is used by other apps for warranties and shipping insurance; hiding their remove button would strand your customer with someone else's charge.

What is always guaranteed: **removing the frame removes its whole set**, however your theme renders it.

If you want those lines to carry less visual weight, turn on **Compact the add-on lines in the cart** in the app embed. See [Design & cart](https://docs.getoptical.app/en/guias/diseno-y-carrito/).

---

## Prices in the form don't match the product page

1. Are you looking at the **same variant**? Prices change per variant.
2. Do you have **multiple countries or currencies** live? Check from the same country as your customer.
3. If you run automatic discounts, remember many apply **at checkout**, not in the cart.

---

## It's showing in the wrong language

**The whole form in another language:** see [Languages & text](https://docs.getoptical.app/en/guias/traducciones/). The usual cause is text typed into a step's boxes, which **applies to every language**.

**Only the button:** if you typed something into *Button text*, that exact text is used in every language. **Leave it empty** and it translates itself.

**A form brought in from another store:** importing adjusts it to your store's language automatically. If a field had no translation, it stays in the original language — edit it with the language selector.

---

## An orange notice says products are missing

*"N referenced products no longer exist in your catalog"*.

It means a treatment or accessory linked to an option has been deleted from Shopify.

- If you **really did delete them**, click **Remove deleted references**.
- If they look familiar and **you think they still exist**, don't click anything — write to us. That button strips the add-ons from your options, and if the warning were wrong you'd lose that setup.

---

## The customer sees "X is not available right now"

On "Add", the drawer explains why Shopify didn't accept the order, in the store's language:

- **"The frame X is sold out. Please choose another frame."** — the chosen variant has no stock. The product-page button should already read "Sold out"; if not, check [the product button](https://docs.getoptical.app/en/guias/boton-del-producto/#when-the-frame-is-sold-out).
- **"X is not available right now. Please let the store know so they can check it."** — a treatment, colour or accessory in the form is out of stock, in draft, archived or off the Online Store channel. That one is yours to fix: open the form and, on the **Steps** tab, look for the "Sold out", "Draft" or "Not on Online Store" badges (they show on their own when you open it; **Check prices** reads them again).
- **"You already have the maximum available of X in your cart."** — the customer already holds every remaining unit in the cart.
- **"X is no longer available. Go back and choose another option."** — an option the customer had already picked can no longer be sold: it sold out, or its product is in draft, archived, off the **Online Store** sales channel or deleted. It shows as soon as the app knows, without waiting for "Add": the drawer removes that answer and, if the step requires one, won't let them continue until they choose another. Open the form: the editor flags which product it is with a badge.
- **"Cannot find variant"** (in your store's language) — a product linked in the form isn't on the **Online Store** sales channel, or was deleted. Shopify doesn't say which one, and it rejects the frame along with it. Getting here is rare now: the drawer shows those options as "Sold out" before anyone picks them, the editor warns you when you open the form and, if Shopify rejects the add without explaining, the drawer checks again and names the option instead of showing this sentence. If you do see it, check the products behind the options that were picked and [put them on the channel](https://docs.getoptical.app/en/empezar/antes-de-empezar/#how-to-put-a-product-on-the-online-store-channel).
- Any other sentence is Shopify's own.

Analytics counts these under **Add-to-cart errors**.

---

## I changed something and the store looks the same

Saving does **not** publish. Hit **Sync now** on the form and wait for it to say *Synced*.

If it says *Sync failed*, try again. If it keeps failing, write to us with the form name.

---

## When you write to support

The more of this you send, the faster we fix it:

- **URL of the product** where it fails (and the store password if it's protected)
- **Theme name and version**
- **What you expected and what happened**
- A **screenshot** or short video
- If you're comfortable: turn on **Debug mode** in the embed settings, reproduce the problem, open your browser console (F12) and paste what appears

That last one speeds things up the most: it tells us exactly how far the app got before it failed.

**[support@getoptical.app](mailto:support@getoptical.app)**

---

# Plans & billing

> Optical Form plans, 14-day free trial and 0% commission.

Source: https://docs.getoptical.app/en/facturacion/planes/
Language: en

Optical Form charges a **flat price** and **0% commission** on your sales. Billing runs through **Shopify App Pricing**, so you choose and change your plan on Shopify's own checkout page and the charge appears on your Shopify invoice.

## Plans

| Plan | Price | Includes |
|---|---|---|
| **Pro** | $49/mo or $490/year | Everything the app does today: prescription glasses, **contact lenses** and unlimited configurators |
| **Plus** *(coming soon)* | $99/mo or $990/year | + save & reuse prescriptions, reordering, contact-lens subscriptions and priority support |

Paying yearly saves you two months. Every plan includes a **14-day free trial**. Prices are in **USD**.

## Free trial

The 14 days belong to the **subscription**, not to the install: the clock starts the day you pick a plan in Shopify. You're not burning trial days while you think about it.

The 14 days are not charged upfront. Cancel before they end and you won't be billed.

## What happens from the moment you install

There are **two separate periods**, and it pays not to mix them up: the **14-day welcome window**, which starts when you install, and the **14-day free trial**, which starts when you pick a plan. They don't overlap and one doesn't eat into the other: you can use the first in full and still get the second in full afterwards.

| When | What happens |
|---|---|
| **Day 0 — you install** | Everything works, **with no plan chosen**: you can build and edit forms, assign them and publish them to your storefront. Four sample forms are already there as drafts. The Home shows a yellow notice with the date the welcome window ends and the days left. |
| **Day 3** | If you still haven't picked a plan, we email you to point out that your trial days haven't started counting. |
| **Day 11** | A second email, with the date the welcome window ends. |
| **Day 14 — the welcome window ends** | Your configurators stop showing on your storefront and forms can no longer be edited. **Nothing is deleted**: forms, steps, add-ons and settings are kept exactly as they are, and go back live the moment you pick a plan. |
| **You pick a plan — whenever you like** | Shopify's page opens and you approve the charge. Your **14-day free trial** starts, with nothing billed. Cancel before it ends and you pay nothing. |
| **Day 15 of the trial** | Shopify bills $49 (or $490 if you chose yearly) on your Shopify invoice. |

Two details that save surprises:

- **Uninstalling and reinstalling does not reset the 14-day welcome window**: it counts from the first install.
- Shopify remembers trial days you've used for 180 days: use 10 trial days, cancel, come back two months later, and you have 4 left, not 14.

To pick a plan: inside the app, open **Plans & Billing** and click **View plans & pricing**. That opens Shopify's page where you approve the charge — it is the only route to payment. Once you approve it, Shopify sends you back to the app's Home: for a few seconds you will see **"Activating your plan…"** while we confirm the subscription with Shopify, and then your active plan with your configurators published again.

## Agencies and development stores

If you're building the store for a client from a Shopify Partners development store, **Pro costs nothing there**, and the welcome clock stops the moment you pick it. How it works, and what happens when you move to the real store, in [Agencies and development stores](https://docs.getoptical.app/en/desarrolladores/tiendas-de-desarrollo/).

## Changing plan

You can upgrade, downgrade or cancel at any time from within Shopify — no need to contact support.

## No commission

We take no percentage of your sales. The plan price is all you pay — you keep 100% of every sale.

---

# Theme integration

> How Optical Form installs theme-agnostically, its hooks and cart grouping.

Source: https://docs.getoptical.app/en/desarrolladores/integracion/
Language: en

Optical Form works on **any Online Store 2.0 theme** — the ones that let you add blocks from the theme editor — and needs no developer to install. It is verified on **Dawn** and **Horizon**; for custom themes there are adapters and the hooks below. This page summarizes the integration layer for anyone who wants to customize it. For the block and embed visual settings, see [Button & cart (theme)](https://docs.getoptical.app/en/desarrolladores/boton-y-carrito/).

## Variant resolution (theme-agnostic)

The drawer and trigger are standalone web components that are **not** re-rendered on variant change. So Optical Form resolves the current variant **lazily** (at open and at add-to-cart), in this priority order:

1. Merchant hook: `window.OpticalFormHooks.getVariantId(triggerEl)`
2. Configurable block selector (the *Variant input selector* setting)
3. Standard product form input `[name="id"]` (Dawn/Horizon and most themes)
4. URL parameter `?variant=`
5. Fallback to the server-rendered value

## Subscription plan (subscription apps)

The configurator never renders a plan selector: the customer picks the plan on the product page, with whatever subscription app the store runs (Shopify Subscriptions, Appstle or any other), and Optical Form **carries that choice** to the cart. It is resolved at add time, in this order:

1. Merchant hook: `window.OpticalFormHooks.getSellingPlanId(triggerEl)`
2. A `[name="selling_plan"]` inside **this product's** product form (`form[action*="/cart/add"]` whose `[name="id"]` is one of its variants): a checked radio, a `<select>` or a hidden input; whatever is there is the answer, including "one-time purchase" (empty)
3. Any `[name="selling_plan"]` on the page (Appstle renders its radios in an app block outside the form)

The plan goes on the **main line only** (add-ons and accessories are one-time purchases) and only when the variant has that plan allocated: the drawer shows the plan price in the footer, on the buttons and in the summary, and the cart charges that same amount. If the subscription app patches `fetch` (Appstle does), it writes the same value we already send.

## Hooks (no fork required)

```js
window.OpticalFormHooks = {
  // Return the selected variant id (highest priority).
  getVariantId(triggerEl) { return /* variant id */; },
  // Optional: override the price (in cents) for a variant.
  getVariantPrice(variantId, triggerEl) { return undefined; },
  // Optional: the id of the chosen subscription plan (highest priority); undefined = read it from the product page.
  getSellingPlanId(triggerEl) { return undefined; },
  // Optional: turn off cart bundle grouping.
  disableCartGrouping: false,
};
```

## Cart grouping

Add-ons and accessories are added as separate line items linked via `parent_id` (Shopify's native bundle — needed for cascade-remove, checkout and order emails). Since themes render them as flat rows, **CartBridge** **reorders** them so each child sits directly under its parent line, and marks each row with its role: `ofd-bundle-parent` (plus `ofd-set-fixed` for a pair of contact lenses), `ofd-bundle-child` plus `ofd-bundle-addon` or `ofd-bundle-accessory`; and inside the row, `ofd-ctl-qty` on the quantity stepper and `ofd-ctl-remove` on the remove control.

**The set's quantities are squared by the bridge**, not by CSS: Shopify's nested lines do not follow their parent, so when the customer raises the frame from the cart, CartBridge multiplies the add-ons with it in a single `POST /cart/update.js` (with the theme's sections in the same response), puts back an add-on changed on its own, leaves accessories free and puts a pair of contact lenses back to its boxes. It emits `optical-form:cart:resync` with what changed (see [Events](https://docs.getoptical.app/en/desarrolladores/eventos/)). Under "Lock" the frame goes back to 1. One pass per change, never a loop, never adds anything.

By default **the app ships no cart CSS at all**: which controls each row shows is the merchant's decision in the app embed (**Add-ons in the cart**, **Hide the remove button of accessories**, **Hide the quantity selector of contact lenses**), and those rules only reach the rows of an Optical Form set: other apps' remove buttons (warranties, shipping insurance) are left alone. To fine-tune the look: the **Compact the add-on lines in the cart** checkbox (`cart_tidy_addons`, off by default) and the **Custom CSS** field. See [Design & cart](https://docs.getoptical.app/en/guias/diseno-y-carrito/) and [Tested themes](https://docs.getoptical.app/en/guias/temas-probados/#any-theme-the-classes-the-bridge-leaves).

Cart selectors and the after-add behavior are set in the app embed — see [Button & cart](https://docs.getoptical.app/en/desarrolladores/boton-y-carrito/). CartBridge **auto-detects** most themes' patterns; you only need to override selectors on non-standard themes.

## Configurator events

The hooks above point inwards: the theme answers something the app asks. These events go the other way — **the app tells the page what the shopper is doing**, so your analytics, your chat widget or your abandoned-cart flow can live where they already live, without needing a feature from us.

You don't have to do anything to get them. If nobody listens, nothing happens. What to build on top of each one, with examples for chat, analytics and abandonment: [What to do with each event](https://docs.getoptical.app/en/desarrolladores/eventos/).

```js
document.addEventListener('opticalform:step:rendered', (e) => {
  gtag('event', 'lens_configurator_step', {
    step_type: e.detail.stepType,
    step_index: e.detail.stepIndex,
    session_id: e.detail.sessionId,
  });
});
```

They are dispatched on `<optical-form-drawer>` and **bubble**, so you can listen on the element or on `document`.

| Event | When | Own fields |
|---|---|---|
| `opticalform:open` | the configurator opens | — |
| `opticalform:step:rendered` | the shopper lands on a step | `isFirst`, `isLast` |
| `opticalform:validation:error` | a step stops them moving on | — |
| `opticalform:addtocart:start` | the add begins | — |
| `opticalform:addtocart:success` | the cart accepted it | `lineCount`, `totalPrice`, `currency`, `sellingPlanId` (or `null`) |
| `opticalform:addtocart:error` | it failed | `kind` |
| `opticalform:close` | it closes | `completed` |
| `optical-form:cart:orphan` | a frame in the cart is missing one of its child lines: the customer removed the lenses from the theme's cart | `groupId`, `key`, `expected`, `actual` |

The last one is not emitted by the configurator but by the cart bridge, on `document`, as soon as it spots a frame without the lenses or treatments it left with: the row also gets the class `ofd-bundle-orphan` and a translated notice underneath. The app deletes nothing and never blocks checkout — the event is there so you decide (ping your chat, remove the frame, whatever fits). While the bridge rearranges the cart after an add, the checkout buttons are disabled for a moment and `<html>` carries the class `ofd-cart-busy`. Both can be switched off in the bridge configuration: `orphanNotice: false` and `guardCheckoutWhileBusy: false`.

They all carry the same context:

```js
{
  version: 1,
  sessionId,            // random, per drawer session — stitches one visit together
  productId, variantId,
  stepIndex, stepId, stepType,
  totalSteps,           // steps CONFIGURED, not the ones this shopper will walk
}
```

`kind` is `'throttled' | 'unavailable' | 'unknown'`: the cause, not the message — the message is a label the merchant can rewrite. Only `throttled` is worth retrying.

`completed` tells “they finished” from “they left”, which is the whole difference when you're recovering an abandonment.

`totalPrice` is in **cents**, and only on `:addtocart:success`.

### What these events never carry

**They say WHERE the shopper is, never WHAT they answered.** A `CustomEvent` is readable by every script on the page, so the payload is a closed list: it never contains the prescription values, the uploaded file or its name, the photo of the prescription, the merchant's own text or the step's DOM node.

Two things worth knowing before you build on this:

- **`stepType` is inferred health data.** Reaching the prescription step means that person has a refractive error. It's included because without it the events are useless, and because the same inference is already within reach of any script on the page. Handle it accordingly.
- **`totalPrice` only after the add.** Once added, that figure is in `/cart.js` for anyone to read. Before the add it would be new information, and in a contact-lens form it would reveal a single-eye order.

### They notify, they don't intervene

None of them is cancelable: `preventDefault()` does nothing. That's deliberate. A/B tests and merchant-side validation rules will need a different mechanism, and it will be added as one rather than by changing what these mean.

### Versioning

`version` only goes up if an existing field **changes shape**. Adding new fields doesn't bump it: a listener reading what it already knew keeps working. Events are never renamed or removed without a major version change.

### Re-renders

`:step:rendered` fires when the step **changes**, not on every repaint: attaching a file, the contact-lens catalogue narrowing a combination, or mutually-exclusive options all redraw the panel without moving the shopper. If you need to know when new HTML lands — a translation layer, say — use a `MutationObserver` on the panel.

## Full reference

The technical detail (resolver, CartBridge, selectors, events) lives in `INTEGRATION.md` inside the app extension: `extensions/optical-form-ext/INTEGRATION.md`.

---

# Button & cart (theme settings)

> The block and embed settings configured in Shopify's theme editor.

Source: https://docs.getoptical.app/en/desarrolladores/boton-y-carrito/
Language: en

Beyond the app panel, Optical Form exposes settings in Shopify's **theme editor**: a **block** for the button and an **app embed** for the drawer and cart.

## "Optical Form" block (the button)

Added to the product section, it controls the button that opens the drawer.

- **Content**: button text (empty = the default translated text) and, optionally, an **icon** from your Files library, with its position (before or after the text) and the gap to the text.
- **Colors**: background, text and border, each with a hover variant. Neutral dark grey by default.
- **Shape & typography** (shared): radius, border width, font weight, letter-spacing (px) and text case.
- **Desktop** and **Mobile** separately: shrink-to-fit, width (%), vertical/horizontal padding and font size. The cut-off is 750px.

**The button inherits no tokens**

The button's colors do **not** fall back to the drawer's `--ofd-*` tokens. Those are applied to the panel (`_applyStyling` → `this.panel`) and the button lives outside it, so it would inherit the app CSS `:root` — that is, Optical Form's own brand colour leaking onto the merchant's storefront. Hence the button's defaults are neutral and explicit.

- **Advanced → `variant_input_selector`**: CSS selector for the selected variant; only if the theme doesn't update `[name="id"]` or `?variant=`. See [Theme integration](https://docs.getoptical.app/en/desarrolladores/integracion/).

## "Optical Form Drawer" app embed

Enabled under **App embeds**, it controls the drawer and its relationship with the theme's cart.

**Cart appearance**

- **Compact the add-on lines in the cart** (`cart_tidy_addons`) — off by default. Shrinks the add-on lines so the frame stays the headline. It only changes sizes: which controls each line shows is decided by the next three settings. Verified on Horizon 4.x and on Split; on themes that don't print that class it does nothing.
- **Add-ons in the cart** (`cart_addon_rows`) — **"Visible without controls"** by default since October 2026 (before, "Visible with their controls"; if you had the embed enabled already, you keep your choice): no quantity stepper and no remove button. "Hidden" does not paint their lines in the cart at all. They are still charged and still appear at checkout and on the order: the frame's line shows the frame's price while the cart total includes them, and what the customer chose stays readable under the frame.
- **Hide the remove button of accessories** (`cart_accessory_remove`) — off. They still go when the frame is removed.
- **Hide the quantity selector of contact lenses** (`cart_contact_lens_selector`) — on by default since October 2026 (before, off). Their boxes per eye are chosen in the configurator and the app puts the quantity back if anything changes it in the cart; this only hides the selector.
- **Custom CSS** — rules to override any drawer or button style. It loads on every storefront page, so it can also restyle how your theme prints the form's line item properties in the cart.

**Cart integration**

- **After add to cart** (`cart_after_add`): open the cart drawer, redirect to `/cart`, or do nothing. "Do nothing" only means the bridge opens nothing itself: the theme still receives the standard `shopify:cart:lines-update` (`action: 'add'`), and Horizon 4.x opens its drawer on it whenever its `cart-drawer-component` carries `auto-open` (its own **"Add to cart" auto-opens drawer** setting, under Theme settings › Cart; off by default on Horizon 4.2.0). The theme wins. Since 1.5 the cart lines travel in the same request as the add and in the event's promise (`detail.sections`), so Horizon paints them before opening.
- **Keep the cart in sync** (`cart_intercept`) — **on by default**. On themes with Shopify's standard cart events it listens passively; on older themes it monitors cart API calls.
- **Set quantity from the cart** (`cart_set_quantity`) — **"Scale"** by default: when the customer raises the frame's quantity in the cart, the add-ons multiply with it (two lenses per frame, one treatment per frame…). **"Lock"** puts it back to 1 with a short notice under the line. In both modes an add-on changed on its own goes back to its place, and **contact lenses are never scaled**: their boxes per eye are set in the configurator and any change goes back to them with its own notice. Both notices are translated and can be changed in the app's locales.
- **Accessories in the cart** (`cart_accessory_quantity`) — **"Free quantity"** by default: solutions, cases and other extras are changed by the customer and do not multiply with the frame. "Follow the frame" treats them like one more add-on.
- **When a lens or treatment is removed** (`cart_orphan_action`) — **"Remove the whole set"** by default: when the customer removes a lens, a treatment or a colour from the cart, the app removes the frame and the rest of its add-ons in one request, with a short notice in the cart (translated text, `cart_set_removed_notice` in the locales). An accessory removed on its own never triggers it. "Keep the frame and show a notice" leaves the frame marked with the notice under the line, as before, and removes nothing: the decision is yours, with the `optical-form:cart:orphan` event.

**The control settings ship without effect**

Everything above ships as it looked until now: nothing hidden, and the add-ons following the frame. The rules that hide controls reach the themes we measured (Horizon 2.x to 4.x, Dawn 15 and 16, Split) and, on any other, the marks the bridge leaves on the controls of each row of the set. See [Tested themes](https://docs.getoptical.app/en/guias/temas-probados/#any-theme-the-classes-the-bridge-leaves).

**Advanced** — only if your theme isn't picked up automatically:

- **Open the drawer from the cart icon** (`cart_intercept_icon`) — **off by default**. Turn it on only if clicking the icon does nothing.
- **CSS selectors** (empty = auto-detect): cart count, cart icon and **section IDs to refresh**. There is no separate cart drawer selector: it is detected automatically.
- **Debug mode** — logs CartBridge activity to the browser console.

**Start with auto-detect**

Leave the selectors empty: CartBridge auto-detects the patterns of Dawn, Horizon and most themes. Only fill them in if the cart doesn't refresh or the drawer won't open.

---

# What to do with each event

> The eight events the configurator emits, one by one, and what you can build on top of them with your chat, your analytics or your cart recovery, without touching the app.

Source: https://docs.getoptical.app/en/desarrolladores/eventos/
Language: en

The configurator tells you what the shopper is doing through browser events. Nothing to switch on: they are always emitted, and if nobody listens nothing happens. This page goes event by event with concrete ideas; the technical contract (shared fields, versioning, what they never carry) lives in [Theme integration](https://docs.getoptical.app/en/desarrolladores/integracion/#configurator-events).

## How to listen

They are dispatched on `<optical-form-drawer>` and **bubble**, so listening on `document` is enough. All of them carry a `detail` with the same context: `sessionId` (stitches a whole visit together), `productId`, `variantId`, `stepIndex`, `stepId`, `stepType` and `totalSteps`.

```js
document.addEventListener('opticalform:open', (e) => {
  console.log('configurator opened on product', e.detail.productId);
});
```

Two limits worth knowing before you build: the events **never carry the shopper's answers** (no prescription, no file, no texts) and **cannot be cancelled**. They say where the shopper is, not what they answered, and they do not let you intervene.

## The ten events

### `opticalform:open` — the configurator opens

The first moment you know this person wants to build glasses, not just look at a frame.

- **Load your chat only now.** If your chat loads lazily for privacy reasons, this is the right trigger: someone who looks without touching leaves no third-party cookies.
- **Tag the session** in your chat or analytics: "is configuring glasses" is worth more than "viewed a product".
- **Start a clock**: the time from here to `:addtocart:success` is your real configuration time.

```js
document.addEventListener('opticalform:open', () => {
  if (!window.myChatLoaded) loadMyChat(); // your function, your provider
});
```

### `opticalform:step:rendered` — the shopper reaches a step

Also carries `isFirst` and `isLast`. Emitted when the step **changes**, not on every re-render.

- **Funnel by step** in your analytics: you will know where people stop, which is the question that decides what to fix.
- **A contextual chat message** when they reach the prescription (`stepType` `graduation`, `reading_rx` or `contact_lens`): "Got your prescription handy? If not, upload a photo." Once per session, not on every step.
- **Prepare the finish** when `isLast` is `true`: for example, mention free shipping.

```js
document.addEventListener('opticalform:step:rendered', (e) => {
  dataLayer.push({ event: 'lens_step', step: e.detail.stepType, index: e.detail.stepIndex });
});
```

### `opticalform:validation:error` — a step will not let them move on

It does not carry the failing value, only the step.

- **Count where people stumble.** If one step concentrates the errors, the step is the problem: its help text, its example, whether it should be required.
- **Offer help after a few tries**: on the second or third error on the same step, the chat can open with a direct question.

### `opticalform:addtocart:start` — the add begins

Between this event and the next one the configurator is talking to the Shopify cart.

- **Hide what gets in the way** while adding, such as a chat launcher floating over the button.
- **Measure the latency** to `:addtocart:success`: if it grows, something changed in the theme or in a cart app.

### `opticalform:addtocart:success` — the cart accepted it

Carries `lineCount`, `totalPrice` (in cents) and `currency`. This is your conversion event.

- **Send the conversion** to GA4, Meta or TikTok with its value. Before this moment the price deliberately does not travel; after it, it is already in `/cart.js`.
- **Recommend the extra they skipped**: a case, a second pair, a treatment.
- **Explain the cart** to first-timers: the frame and every lens or treatment arrive as separate lines with their own price. That is what your lab receives.

```js
document.addEventListener('opticalform:addtocart:success', (e) => {
  gtag('event', 'add_to_cart', {
    value: e.detail.totalPrice / 100,
    currency: e.detail.currency,
    items: [{ item_id: String(e.detail.productId), quantity: e.detail.lineCount }],
  });
});
```

### `opticalform:addtocart:error` — it failed

Carries `kind` — the cause — and `line` — which line failed. `kind` is one of `sold_out` (the frame is sold out), `addon_unavailable` (a treatment, colour or accessory cannot be sold), `limit` (the cart already holds all the stock), `unavailable` (something no longer exists), `throttled` (Shopify asked to wait) or `unknown`; `line` is `frame`, `addon` or `unknown`. It also fires when the drawer refuses to send without calling Shopify, because it already knew the frame or an add-on was sold out.

- **Alert support** with `sessionId`, `productId`, `kind` and `line`: you get there before the shopper writes.
- **Retry only when `throttled`**; the others are not fixed by repeating.
- **Watch `addon_unavailable`**: each one is a lens, colour or accessory variant that couldn't be sold while people were choosing it — the editor shows it under **Check prices**. `sold_out` is the frame: the product-page button should already read "Sold out".

### `opticalform:close` — it closes

Carries `completed`: `true` if they finished, `false` if they left. That is the whole difference when recovering an abandonment.

- **Abandonment with context**: with `completed` at `false` you know the step (`stepType`, `stepIndex`) and the product. A chat message, a "we saved your configuration" note or an email form are worth more here than any exit popup.
- **Leave finishers alone**: with `completed` at `true`, the only thing to do is let them go to the cart.

```js
document.addEventListener('opticalform:close', (e) => {
  if (!e.detail.completed) myChat.message('Any questions? Write to us here.');
});
```

### `opticalform:resume` — the shopper resumes a half-finished configuration

If they closed the configurator before finishing and come back to the same product within 7 days, the app offers “Continue where you left off”. This event fires when they press it. It carries `restoredSteps`: how many steps got their answer back. Like every event, **it does not say what they answered**. And it only fires if the merchant has turned on “Remember a half-finished configuration” under Design › Navigation (it is off by default).

- **Measure whether it helps**: how many `resume` against how many `close` without `completed` tells you whether it is worth keeping on. The Analytics tab already counts it (“N resumed a half-finished configuration”).
- **Change the chat's tone**: someone resuming has already decided half of it; “need a hand with the prescription?” fits better than “shall we start?”.

```js
document.addEventListener('opticalform:resume', (e) => {
  myAnalytics.event('configurator_resumed', { steps: e.detail.restoredSteps });
});
```

### `optical-form:cart:orphan` — a child line is missing in the cart

This one is not emitted by the configurator but by the cart bridge, on `document`, when it detects a frame without the lenses, treatments or colours it left with: the customer removed them from the theme's cart (a removed accessory does not count). Carries `groupId`, `key`, `expected`, `actual` and `action`: `'removed'` when the app removed the whole set — what it does by default since October 2026; it also carries `lines`, the keys of the lines it set to 0 — or `'notice'` when you chose "Keep the frame and show a notice" in the embed: then the app paints a translated notice under the row and **removes nothing and blocks no checkout**.

- **You decide** (with "Keep the frame and show a notice"): remove the frame, warn through chat, or let it through if in your store a frame can be bought on its own.
- **Measure it**: how many remove the lenses tells you whether the add-on price surprises people in the cart.

### `optical-form:cart:resync` — the bridge squared a set

Also from the cart bridge, on `document`, every time it corrects the quantities of a set after a customer's change in the theme's cart: the frame went up and the add-ons were multiplied with it ("Scale"), or the frame went back to its base ("Lock", or a pair of contact lenses). Carries `groupId`, `mainKey`, `quantity` (the frame's quantity after the adjustment), `base`, `sets`, `mode` (`'scale'` or `'lock'`) and `changed` (a list of `{ key, from, to }` with every line touched). It may carry `reason`: `'form-quantity'` when what went back is a pair of contact lenses to its boxes, `'unknown-ratio'` when the bridge does not know the set's ratio and touches nothing, and `'capped'` when Shopify did not accept the requested quantity (out of stock) and the set is marked `ofd-bundle-mismatch`.

- **Show the adjustment your way**: the app paints a translated notice under the line; with this event you can replace it with yours.
- **Measure it**: how many raise the frame from the cart, and how often Shopify caps it for stock.

## Three complete recipes

**Funnel in Google Analytics 4.** Listen to `:open`, `:step:rendered`, `:validation:error`, `:addtocart:success` and `:close`, and send each as an event with `stepType` and `stepIndex`. In GA4, a funnel report by `stepIndex` shows the drop step by step; `sessionId` as a custom dimension stitches the whole visit together.

**A chat that accompanies.** Load your provider on `:open`, keep in `sessionStorage` which messages you have already shown so you do not repeat them, and send at most one per milestone: reaching the prescription, adding to the cart, closing without finishing. If your chat lives at the bottom right, make room for it with the **Space kept free at the right of the footer** setting (Design › Navigation) so it does not cover the continue button: see [Design & cart](https://docs.getoptical.app/en/guias/diseno-y-carrito/).

**Abandonment recovery.** On `:close` with `completed` at `false`, store `productId` and `stepIndex`; if you have the customer's email (they are logged in, or your popup asks for it), your email tool can send a "pick up where you left off" with the product link. The app does not save half-finished configurations: what you recover is the intent, not the answers.

## What you cannot do with them

- Cancel a step, an add or a close: `preventDefault()` does nothing, on purpose.
- Read the prescription, the uploaded file or the merchant's texts: the `detail` is a closed list. `stepType` does travel, and it is inferred health data; treat it as such.
- Change what a step validates: that is configured in the form, not in a script.

Versioning and re-render details are in [Theme integration](https://docs.getoptical.app/en/desarrolladores/integracion/#versioning).

---

# Agencies and development stores

> Building an optician's store for a client — Pro is free on your development store, what happens when you move to the real store, and what we need from your theme.

Source: https://docs.getoptical.app/en/desarrolladores/tiendas-de-desarrollo/
Language: en

If you're an agency or a developer building an optician's store for a client, you'll usually start on a Shopify Partners **development store**. Optical Form is built with that path in mind. Here's what changes compared with a regular store, and what doesn't.

## Pro costs nothing on a development store

Shopify lets developers test apps on their development stores **without paying the subscription**, and Optical Form has that option switched on. When you click **View plans & pricing** inside the app, Shopify's page offers **Pro at $0**: approve it and you have a real subscription, with no charge and no expiry for as long as the store remains a development store.

There's no trial clock to watch and no card to enter. It's the same app, with everything Pro does.

## The 14-day welcome window applies here too

As on any store, installing gives you [14 welcome days](https://docs.getoptical.app/en/facturacion/planes/#what-happens-from-the-moment-you-install) with the full app and no plan chosen. On a development store that has one practical consequence: if you don't pick the free Pro plan, **on day 14 the configurators switch off just the same**, in the middle of your work. Pick it on day one and forget the calendar.

## When you move to the client's store

The development store and the live store are two different stores to Shopify, so the app is installed **again** on the client's store, from the [App Store](https://apps.shopify.com/optical-form?locale=en). That's where a plan is chosen and the charge approved: the **14-day free trial** starts that day, not the day you installed on the development store. Your client can cancel before it ends and pay nothing.

To carry your work over, **export each form as JSON** from its Settings tab and import it on the live store. One detail: add-ons and accessories point to products of the store where they were created, so after importing, review those links and point them at the client's products. See [Copying a form](https://docs.getoptical.app/en/guias/copiar-formulario/).

Theme settings — the app embed and the button block — don't travel either: you switch them on again in the client's theme. The Setup guide on the Home detects it and flags it for you.

## What you can test on a development store

The whole shopper journey, checkout included: development stores accept **test orders** through Shopify's test gateway, so you can see how the prescription reaches the order and the confirmation email before a real customer exists. The only thing you can't do is take real money.

## Your theme

Optical Form works on any Online Store 2.0 theme, but **the cart is drawn by the theme**, and that's where themes differ. Start with [Tested themes](https://docs.getoptical.app/en/guias/temas-probados/): if the client's theme is there, you'll find what to adjust and the CSS already measured.

If it isn't, send [support@getoptical.app](mailto:support@getoptical.app) **a theme preview link with the form active on a product page**. With that we measure how that theme draws the cart and send you back the recipe — what to change in the embed settings and which CSS to paste — before it goes live. It's what we do with every new theme, and it's better done early than late.

## If something doesn't fit

Write to us. An agency that builds opticians' stores matters a lot more to us than a one-off install, and integration questions get fast answers.

---

# FAQ

> Common questions about Optical Form.

Source: https://docs.getoptical.app/en/faq/
Language: en

## Do you take a commission on my sales?

No. Ever. GetOptical charges a **flat plan price** — monthly or annual — and you keep 100% of every sale.

## Can a customer buy without filling in the form?

Yes, if you allow it — and that is a business decision of yours, not a fault in the app. Your theme keeps its own buy buttons (the one on the product page, the bar that appears as you scroll, and quick-add on collection pages), and those add the frame **with no lenses and no prescription**.

That may be exactly what you want, if you also sell bare frames. And if it isn't, it takes ten minutes to close with a dedicated product template. Both routes, step by step, in [Controlling how each frame is bought](https://docs.getoptical.app/en/guias/evitar-compras-sin-configurar/).

## Does it work on my theme?

Yes, on any **Online Store 2.0** theme — the ones that let you add blocks from the theme editor. Optical Form uses a theme-agnostic layer that detects the selected variant and bundles the cart correctly: verified on **Dawn** and **Horizon**, with adapters for custom themes. See [Theme integration](https://docs.getoptical.app/en/desarrolladores/integracion/).

## What happens if the customer presses the browser's Back button?

It goes back one step, just like the panel's "Previous" button: opening the configurator and every step forward leave an entry in the browser history, so the phone's back gesture does what the customer expects. On the first step, Back closes the configurator and the customer stays on the product page — it never takes them to another page. On close, those entries are removed and the history is left as it was.

## Do I need a developer to install it?

No. It installs by enabling an **app embed** and assigning the form to a product. Only heavily customized themes may need a CSS selector tweak. See [Install](https://docs.getoptical.app/en/empezar/instalacion/).

## How are lens types and treatments billed?

As **real Shopify products** linked to options ([add-ons](https://docs.getoptical.app/en/guias/accesorios-y-addons/)). They're added as separate lines and grouped under the main product as a bundle, so Shopify includes them on the order and they reach your lab.

## Can the customer pick the color of a tint or a polarized lens?

Yes. Any option in the form can carry a row of **selectable colors**: the customer taps the color they want and **only that one is charged** and reaches the order with its reference. Each color is a variant of one of your Shopify products, and the color dot is that variant's photo — nothing else to set up. To group colors (classic, fashion, gradient…), create one product per group. See [Selectable colors](https://docs.getoptical.app/en/guias/accesorios-y-addons/#selectable-colors-per-option).

## I changed a form and the store doesn't update. Why?

Saving doesn't publish. You must click **Sync** for changes to reach the storefront, and the form must be **Active**. See [Sync](https://docs.getoptical.app/en/guias/sincronizacion/).

## Can a product have two forms?

No. **Each product takes a single form**, even though one form can carry many products.

If you assign a form a product that already belonged to another, **the new one takes it**, with no warning: the previous form loses it silently. If what you want is the same frame sold **with and without** the configurator, you need neither two forms nor two products: your theme's button and Optical Form's live side by side on the same page (see [Controlling how each frame is bought](https://docs.getoptical.app/en/guias/evitar-compras-sin-configurar/)). Two different **forms** on the same frame do require two products. See [Creating a form](https://docs.getoptical.app/en/guias/crear-formulario/).

With collections the rule is the same but layered: the product's own assignment always wins, and if the form only reaches it through a collection, it shows the form of the first assigned collection it belongs to. See [Products and collections](https://docs.getoptical.app/en/guias/productos-y-colecciones/).

## Can I copy a form to another store?

Yes. **Export the form as JSON** from the Settings tab and use **Import from JSON** on the other store.

## Is there a free trial?

Yes — **14 days**, billed through Shopify. Cancel before they end and you won't be charged.

One detail that decides when to subscribe: **the trial starts when you approve the subscription, not when you install the app**. The days you spend deciding cost you nothing.

And before the trial there's something else: a **14-day welcome window from the moment you install**, with the full app and no plan chosen. When it ends, the configurators switch off on your storefront until you pick a plan — but nothing is deleted. The full day-by-day timeline is in [Plans & billing](https://docs.getoptical.app/en/facturacion/planes/#what-happens-from-the-moment-you-install).

## I'm an agency working on a development store — do I pay?

No. On a Shopify Partners development store you can pick **Pro at $0** and build the client's store with no clock running. The real subscription is chosen when the app is installed on the live store, and the 14-day trial starts that day. See [Agencies and development stores](https://docs.getoptical.app/en/desarrolladores/tiendas-de-desarrollo/).

## Do you sell contact lenses?

Yes, and they're included in **Pro** — there's no future plan to wait for. On install you already have a sample **Contact lenses** form, in draft, and **Create form** ships that template.

The customer picks the pack, marks which eyes they're ordering and their per-eye power. If your product carries the catalogue of combinations the manufacturer actually makes, the app resolves the exact reference and sends it on the order, so your lab can order without translating anything.

## Does it work with subscription apps?

Yes. If the customer picks a plan on the product page — with Shopify Subscriptions, Appstle or any app that puts its selector there — before opening the configurator, that plan travels with the frame or the contact lenses: the drawer shows the plan price and the cart charges that same amount. Add-ons and accessories are added as one-time purchases. With no plan chosen, everything works as usual. Developer detail under [Theme integration](https://docs.getoptical.app/en/desarrolladores/integracion/#subscription-plan-subscription-apps).

## Can the customer order two identical frames?

Yes, from the cart: raise the frame's quantity with your theme's stepper and the lenses and treatments multiply with it. If they change an add-on on its own, it goes back to its place. And if you would rather every configured frame always be one unit, set **Set quantity from the cart** to "Lock" in the app embed: it goes back to 1 with a notice. Contact lenses are a different story: their boxes per eye are chosen in the configurator, and any change in the cart goes back to them. See [Tested themes](https://docs.getoptical.app/en/guias/temas-probados/#changing-the-quantity-from-the-cart).

## How is prescription data handled?

**It never reaches our servers.** The prescription and any file your customer uploads travel over TLS **straight into your store's Shopify order**, as line item properties. We don't store them and couldn't read them: the app doesn't request permission to read orders or customers.

That means you are the controller for that data, and access or deletion requests are settled inside your Shopify. You can hide it from what the customer sees without losing it from the order — see [Design & cart](https://docs.getoptical.app/en/guias/diseno-y-carrito/) — and the legal detail is in the [Privacy Policy](https://www.getoptical.app/en/privacy).

## What happens to my data if I uninstall the app?

Your **forms and their product assignments are kept**: if you reinstall, they come back as they were and get published again. The copy of your catalog and the configurator analytics **are deleted after 30 days** — the app reads them back from Shopify whenever it needs them. Your customers' prescriptions were never with us: they travel inside your Shopify orders. When you uninstall you get a single email saying exactly this; if you would rather have everything deleted right away, reply to that email.

## Will you email me?

Only if you need it, and always to your store's Shopify address — never to your customers.

Two things: a few setup nudges if you get stuck on a step (**three at most**, and none at all if you finish setting up), and billing notices if your subscription stops being active. There's no newsletter, no offers, no weekly cadence.

To stop them, **reply to any of them**: it reaches a person and we turn them off. You can also write to [support@getoptical.app](mailto:support@getoptical.app).