---
title: Solucionar problemas de vista previa y publicación
description: Empareja los estados de tienda, compilación, publicación, checkout y dominio con la acción de recuperación más segura.
---

**Ruta de entrada:** Espacio de trabajo → selecciona una tienda → **Escaparate** → reproduce el estado de vista previa o publicación que se muestra en pantalla

## Qué cubre esta guía

Identifica qué capa está fallando—versión del proyecto, vista previa, comprobación de compilación, publicación, catálogo público, checkout o dominio—y toma la acción de recuperación más pequeña y segura.

## Por qué esta distinción es importante

El viaje de la tienda tiene varias capas independientes. Repetir **Publicar** no puede corregir datos de producto faltantes, y actualizar la vista previa no puede reparar una conexión de pago. Comienza con el mensaje exacto y la superficie que falló.

## Disponibilidad y requisitos previos

- Mantén el proyecto abierto y anota la etiqueta de versión actual.
- Registra el mensaje exacto, la ruta de página y si falló en la vista previa o en la URL pública.
- Espera a que el trabajo activo de Runner alcance **Completado**, **Fallido** o **Detenido** antes de iniciar una acción de recuperación conflictiva.
- No elimines dominios, restaures versiones o repitas acciones pagadas solo para probar una teoría.

## Encuentra la capa que falla

1. En **Escaparate**, verifica si existe una versión actual.
2. Confirma si la vista previa normal se abre.
3. Si estás publicando, lee el resultado de la comprobación de compilación antes de seleccionar otra acción.
4. Si la publicación tiene éxito, abre la URL pública en lugar de la URL de vista previa.
5. En la tienda pública, prueba el catálogo y el carrito.
6. Verifica el estado de checkout de Runner y la ruta de checkout real.
7. Si solo la dirección personalizada falla, verifica la Configuración de Dominio al final.

## Controles de recuperación importantes

| Control | Qué sucede cuando se selecciona |
| --- | --- |
| **Actualizar** en la vista previa | Recarga la vista previa actual y borra la selección activa del Modo Diseño y la sesión de deshacer/rehacer. Guarda las ediciones directas pendientes primero. |
| **Corregir** / **Corregir error** | Envía el diagnóstico de vista previa mostrado a Runner como una solicitud de reparación. **Descartar** solo oculta el mensaje. |
| **Corregir con IA** | Cierra la confirmación de publicación y envía su falla de compilación a Runner para reparación; la publicación no comienza. |
| **Reintentar comprobación** | Ejecuta la comprobación de compilación de la tienda nuevamente después de que Runner no pudo alcanzar el workspace. |
| **Abrir Operaciones de la tienda** | Cierra la confirmación de publicación y abre Operaciones de la tienda para que puedas completar la configuración nombrada. |
| **Volver a comprobar la configuración** | Verifica nuevamente la disponibilidad de Operaciones de la tienda después de que su estado no estaba disponible. |
| **Republicar** | Inicia un intento de publicación verificado nuevo después de un resultado fallido o sin enlace. Corrige la causa nombrada primero. |
| **Volver a comprobar el pago** | Verifica nuevamente una conexión de pago habilitada; no prueba un producto, envío o el formulario de checkout. |

## Referencia de estado a acción

| Mensaje o síntoma | Capa | Qué significa | Acción más segura |
| --- | --- | --- | --- |
| **Aún no hay tienda** | Versión del proyecto | No existe una versión previsualizable. | Pídele a Runner que construya la primera tienda. |
| **Construyendo la primera versión…** | Versión del proyecto | Runner aún la está creando. | Sigue el progreso de la tarea; no publiques aún. |
| **Error de compilación** en una versión | Versión del proyecto | Esa versión no está lista. | Abre los detalles de la tarea y pídele a Runner que repare la falla. |
| **Preparando la vista previa…** | Vista previa | Runner está iniciando la vista previa seleccionada. | Mantén la versión más reciente seleccionada; actualiza solo si el progreso se detiene. |
| **No se pudo cargar la vista previa de esta versión** | Vista previa | La versión seleccionada no se pudo mostrar. | Vuelve a la actual, actualiza o intenta otra versión lista. |
| **Reconectando la vista previa** | Vista previa | Runner perdió la conexión de vista previa e intenta nuevamente. | Sigue el recuento de reintentos; reconecta el workspace si la recuperación falla. |
| Barra de error de vista previa con **Corregir** | Vista previa | La página en ejecución reportó un diagnóstico que Runner puede usar. | Selecciona **Mostrar más** para inspeccionarlo, **Corregir** o **Corregir error** para enviarlo a Runner, o **Descartar** solo para ocultar la barra. |
| **Página no encontrada** | Ruta de vista previa o pública | La ruta no existe en esa versión. | Vuelve a `/`, usa navegación visible y pídele a Runner que cree o repare la ruta. |
| **El modo de diseño no se inició** | Modo Diseño | La vista previa editable no se volvió lista. | Selecciona **Intentar de nuevo**, o vuelve a la vista previa actual y actualiza. |
| **Editor visual deshabilitado mientras la IA está procesando** | Modo Diseño | Runner está manejando otra solicitud. | Espera a que Runner termine. |
| **No se pudo cargar el historial de versiones** | Historial de versiones | La solicitud de lista de versiones falló. | Selecciona **Intentar de nuevo**. |
| La restauración está bloqueada | Historial de versiones | Runner está activo o la versión no está lista. | Espera a Runner, luego elige una versión lista. |
| **No pudimos acceder a tu espacio de trabajo** | Comprobación de publicación | Runner no pudo ejecutar la comprobación de compilación. | Selecciona **Reintentar comprobación**; reconecta el workspace si se repite. |
| **Algo salió mal al compilar tu tienda** | Comprobación de publicación | La tienda actual no puede pasar la compilación. | Selecciona **Corregir con IA**, revisa la reparación, luego vuelve a ejecutar las comprobaciones. |
| **La configuración de la tienda está incompleta** | Configuración de publicación | Detalles operativos importantes de la tienda permanecen sin terminar. | Selecciona **Abrir Operaciones de la tienda**. Reconoce solo si la limitación es intencional. |
| **No pudimos verificar Operaciones de la tienda** | Configuración de publicación | El estado de configuración es desconocido. | Selecciona **Volver a comprobar la configuración** antes de considerar un reconocimiento. |
| **No se detectaron cambios de código** | Cambios de publicación | Runner no encontró nada nuevo desde la última publicación. | Cancela, o reconoce un nuevo despliegue del mismo estado solo cuando sea intencional. |
| **La integración de pagos no está configurada** | Configuración de checkout | Algunos flujos de publicación muestran esto antes del lanzamiento cuando no se encuentra una conexión de pago habilitada. | Conecta Stripe; usa el reconocimiento solo para un lanzamiento de solo navegación intencional. Otros flujos informan el estado de checkout después de la publicación. |
| **Error al publicar la tienda** | Publicación | El intento no se completó. | Repara el problema nombrado, luego selecciona **Republicar**. |
| **Enlace de la tienda no disponible** | Entrega de publicación | El intento terminó sin una URL pública utilizable en Runner. | Cierra el diálogo, confirma que el workspace esté listo, luego selecciona **Republicar**. |
| La tienda pública muestra contenido antiguo | Publicación o versión | Los cambios del proyecto más reciente no están en vivo. | Confirma la versión actual más reciente, selecciona **Publicar Cambios** y reabre la URL pública. |
| Producto faltante en tienda pública | Catálogo | La publicación tuvo éxito, pero el producto previsto no es visible. | Verifica el estado del producto, mercado, precio e inventario; publica cambios si es necesario. |
| Acción de carrito faltante o deshabilitada | Catálogo o disponibilidad | El elemento seleccionado actualmente no se puede agregar. | Verifica opciones requeridas, disponibilidad, stock, precio y región. |
| **Pago pausado** | Pago | El flujo posterior a la publicación no encontró una conexión de Stripe habilitada. | Selecciona **Conectar Stripe**, luego prueba nuevamente la ruta de checkout real. |
| **Estado de pago no disponible** | Estado de pago | Runner no puede confirmar la disponibilidad de pago. | Selecciona **Volver a comprobar el pago** y prueba el checkout público independientemente. |
| El dominio personalizado propio muestra una advertencia roja y una tabla **Tipo / Host / Valor** | Dominio | La comprobación de configuración actual del proveedor aún no ha pasado. | Copia exactamente los valores mostrados a tu proveedor. Runner vuelve a comprobar automáticamente mientras la Configuración de dominio permanezca abierta; no hay un botón de verificación manual. |
| **Transferencia en curso** | Dominio | Un dominio se está moviendo entre tiendas. | No inicies otra transferencia; sigue el estado mostrado. |

## Reporta un problema a Runner

Incluye estos detalles en un mensaje:

1. la ruta de página exacta o URL pública;
2. si falló en la vista previa o en la tienda en vivo;
3. la etiqueta de versión actual;
4. el texto de error o estado exacto;
5. el último botón que seleccionaste;
6. el resultado esperado; y
7. si el problema se reproduce después de la acción de reintento documentada.

Para un problema visual, incluye el diseño del dispositivo y una captura de pantalla. Para checkout, detente antes de un cargo real e informa el último paso exitoso.

## Límites de recuperación

- No reanudes ni republiques repetidamente un estado fallido sin cambios. Corrige la causa nombrada primero.
- No restaures una versión anterior mientras Runner está trabajando.
- No elimines un dominio para corregir un problema de tienda o checkout.
- No reclames éxito de lanzamiento hasta que la URL pública, catálogo previsto, carrito y paso de checkout requerido hayan sido verificados cada uno.

## Guías relacionadas

- [Vista previa de tu tienda](./preview-your-store)
- [Prepararse para publicar](./prepare-to-publish)
- [Publicar y republicar](./publish-and-republish)
- [Verifica la tienda en vivo y el checkout](./live-store-and-checkout)
- [Conecta un dominio personalizado](./custom-domains)