> ## Documentation Index
> Fetch the complete documentation index at: https://adminroletesting-justin-client-exports.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Implementaciones de vista previa

> Obtén URLs de vista previa únicas para cada pull request y permite que los revisores vean los cambios en un entorno en vivo antes de fusionar.

Las implementaciones de vista previa te permiten ver cómo se ven los cambios en tu documentación antes de fusionarlos en producción. Cada vista previa crea una URL para compartir que se actualiza automáticamente a medida que haces push de nuevos cambios.

De forma predeterminada, las URLs de vista previa son públicas. Comparte un enlace de vista previa con quien necesite revisar tus cambios.

<div id="create-preview-deployments">
  ## Crear implementaciones de vista previa
</div>

Las implementaciones de vista previa se crean automáticamente mediante solicitudes de extracción o manualmente desde tu dashboard.

<div id="automatic-previews">
  ### Vistas previas automáticas
</div>

<Note>
  Las vistas previas automáticas solo se crean para las solicitudes de extracción dirigidas a tu [rama de implementación](/es/guides/git-concepts#deployment-branch).
</Note>

Cuando creas una solicitud de extracción, el bot de Mintlify agrega automáticamente un enlace para ver la implementación de la vista previa en tu solicitud de extracción. La vista previa se actualiza cada vez que haces push de nuevas confirmaciones a la rama.

<Frame>
  <img src="https://mintcdn.com/adminroletesting-justin-client-exports/PdUMLzGWBM_RlEqQ/images/previews/preview-deployment-light.png?fit=max&auto=format&n=PdUMLzGWBM_RlEqQ&q=85&s=8ab735fa33ea78ef6adb56df638554b4" alt="Enlace para ver la implementación en la línea de tiempo de la solicitud de extracción" className="block dark:hidden" width="1704" height="142" data-path="images/previews/preview-deployment-light.png" />

  <img src="https://mintcdn.com/adminroletesting-justin-client-exports/PdUMLzGWBM_RlEqQ/images/previews/preview-deployment-dark.png?fit=max&auto=format&n=PdUMLzGWBM_RlEqQ&q=85&s=8a9647b7fc7364d58dfdaa6c888c3f01" alt="Enlace para ver la implementación en la línea de tiempo de la solicitud de extracción" className="hidden dark:block" width="1704" height="142" data-path="images/previews/preview-deployment-dark.png" />
</Frame>

<div id="manual-previews">
  ### Vistas previas manuales
</div>

Puedes crear manualmente una vista previa para cualquier branch.

1. Ve a tu [dashboard](https://dashboard.mintlify.com/).
2. Selecciona **Previews**.
3. Selecciona **Create custom preview**.
4. Ingresa el nombre del branch que quieres previsualizar.
5. Selecciona **Create preview**.

<div id="api">
  ### API
</div>

También puedes crear implementaciones de vista previa de forma programática usando el endpoint de la API [Trigger preview deployment](/es/api/preview/trigger). Esto es útil para integrar la creación de vistas previas en pipelines CI/CD o herramientas personalizadas.

<div id="redeploy-a-preview">
  ## Volver a implementar una vista previa
</div>

Vuelve a implementar una vista previa para actualizar el contenido o volver a intentarlo después de una implementación fallida.

1. Selecciona la vista previa en tu [dashboard](https://dashboard.mintlify.com/).
2. Selecciona **Volver a implementar**.

<Frame>
  <img src="https://mintcdn.com/adminroletesting-justin-client-exports/PdUMLzGWBM_RlEqQ/images/previews/redeploy-preview-light.png?fit=max&auto=format&n=PdUMLzGWBM_RlEqQ&q=85&s=fc4d8a11b924bb9d2b4b474c3cca63c5" alt="El menú Previews con el botón de implementación resaltado con un rectángulo naranja." className="block dark:hidden" width="2104" height="634" data-path="images/previews/redeploy-preview-light.png" />

  <img src="https://mintcdn.com/adminroletesting-justin-client-exports/PdUMLzGWBM_RlEqQ/images/previews/redeploy-preview-dark.png?fit=max&auto=format&n=PdUMLzGWBM_RlEqQ&q=85&s=82299a2c945253c448f361abee56aad9" alt="El menú Previews con el botón de implementación resaltado con un rectángulo naranja." className="hidden dark:block" width="2104" height="634" data-path="images/previews/redeploy-preview-dark.png" />
</Frame>

<div id="preview-widget">
  ## Widget de vista previa
</div>

El widget de vista previa aparece en las implementaciones de vista previa y está pensado para ayudarte a navegar y revisar las páginas actualizadas. El widget es un botón flotante en la esquina inferior derecha de tu implementación de vista previa.

<Frame>
  <img src="https://mintcdn.com/adminroletesting-justin-client-exports/PdUMLzGWBM_RlEqQ/images/previews/widget-light.png?fit=max&auto=format&n=PdUMLzGWBM_RlEqQ&q=85&s=83002dcd220ea4a29aa8cf491caba4b1" alt="Widget de vista previa expandido para mostrar la lista de archivos con cambios." className="block dark:hidden" width="820" height="314" data-path="images/previews/widget-light.png" />

  <img src="https://mintcdn.com/adminroletesting-justin-client-exports/PdUMLzGWBM_RlEqQ/images/previews/widget-dark.png?fit=max&auto=format&n=PdUMLzGWBM_RlEqQ&q=85&s=cfc46217a082a38ca6ad5d1b2c08a902" alt="Widget de vista previa expandido para mostrar la lista de archivos con cambios." className="hidden dark:block" width="820" height="314" data-path="images/previews/widget-dark.png" />
</Frame>

1. Haz clic en el widget para mostrar todos los archivos agregados, modificados o eliminados en la vista previa.
2. Haz clic en un archivo para ver los cambios en la página correspondiente.
3. Usa la barra de búsqueda para filtrar la lista de archivos con cambios.
4. Pasa el cursor sobre un archivo y haz clic en el icono **Abrir en el editor** para editar el archivo directamente en el editor web.

El widget solo aparece en las implementaciones de vista previa, no en tu sitio en producción ni en las vistas previas locales.

<div id="restrict-access-to-preview-deployments">
  ## Restringir el acceso a las implementaciones de vista previa
</div>

De forma predeterminada, las implementaciones de vista previa son accesibles públicamente para cualquiera que tenga la URL. Puedes restringir el acceso exigiendo autenticación de la organización para todas las vistas previas o protegiendo con contraseña vistas previas individuales.

<div id="require-organization-authentication">
  ### Requerir autenticación de la organización
</div>

Restringe el acceso a las vistas previas a los miembros autenticados de tu organización en Mintlify.

1. Ve a la sección **Previews** en la página de [Add-ons](https://dashboard.mintlify.com/products/addons) de tu dashboard.
2. Haz clic en el interruptor **Preview authentication** para habilitar o deshabilitar la autenticación de la vista previa.

<Frame>
  <img src="https://mintcdn.com/adminroletesting-justin-client-exports/PdUMLzGWBM_RlEqQ/images/previews/preview-auth-light.png?fit=max&auto=format&n=PdUMLzGWBM_RlEqQ&q=85&s=c60610e5b5a0f3017ff8aa0b01509b38" alt="El interruptor de autenticación de vista previa en la página Add-ons" className="block dark:hidden" width="1460" height="434" data-path="images/previews/preview-auth-light.png" />

  <img src="https://mintcdn.com/adminroletesting-justin-client-exports/PdUMLzGWBM_RlEqQ/images/previews/preview-auth-dark.png?fit=max&auto=format&n=PdUMLzGWBM_RlEqQ&q=85&s=24c3564f5621c6d15153016240086c39" alt="El interruptor de autenticación de vista previa en la página Add-ons" className="hidden dark:block" width="1460" height="434" data-path="images/previews/preview-auth-dark.png" />
</Frame>

<div id="password-protect-an-individual-preview">
  ### Proteger con contraseña una vista previa individual
</div>

<Info>
  Las vistas previas protegidas con contraseña están disponibles en los [planes Enterprise](https://mintlify.com/pricing?ref=preview-deployments).
</Info>

Protege con contraseña una vista previa específica para compartirla con revisores externos sin necesidad de agregarlos a tu organización de Mintlify. Esta opción está disponible al crear una vista previa manual y no se muestra cuando la autenticación de la organización ya está habilitada para tu despliegue.

1. Ve a tu [dashboard](https://dashboard.mintlify.com/).
2. Selecciona **Previews**.
3. Selecciona **Create custom preview**.
4. Ingresa el nombre del branch que quieres previsualizar.
5. Activa **Make private** e ingresa una contraseña. Las contraseñas deben tener al menos 8 caracteres.

<Frame>
  <img src="https://mintcdn.com/adminroletesting-justin-client-exports/PdUMLzGWBM_RlEqQ/images/previews/private-preview-light.png?fit=max&auto=format&n=PdUMLzGWBM_RlEqQ&q=85&s=ad0a8aae5c838cef77980ad7fc6a8acc" alt="El modal Crear una vista previa personalizada con el interruptor Make private activado y un campo de contraseña." className="block dark:hidden" width="820" height="764" data-path="images/previews/private-preview-light.png" />

  <img src="https://mintcdn.com/adminroletesting-justin-client-exports/PdUMLzGWBM_RlEqQ/images/previews/private-preview-dark.png?fit=max&auto=format&n=PdUMLzGWBM_RlEqQ&q=85&s=aa8ed45a6137c7c857a62ee8e64601f6" alt="El modal Crear una vista previa personalizada con el interruptor Make private activado y un campo de contraseña." className="hidden dark:block" width="814" height="750" data-path="images/previews/private-preview-dark.png" />
</Frame>

6. Selecciona **Create preview**.

<div id="troubleshooting-preview-deployments">
  ## Solución de problemas con las implementaciones de vista previa
</div>

Si tu implementación de vista previa falla, prueba estos pasos de solución de problemas.

* **Ver los registros de compilación**: En tu [dashboard](https://dashboard.mintlify.com/), ve a **Previews** y haz clic en la vista previa con error. Los registros de implementación muestran los errores que provocaron el fallo.
* **Revisar tu configuración**:
  * Sintaxis no válida en `docs.json`
  * Rutas de archivos ausentes o incorrectas referenciadas en tu `navigation`
  * frontmatter no válido en archivos MDX
  * Enlaces de imágenes rotos o archivos de imagen ausentes
* **Validar localmente**: Ejecuta `mint dev` en local para detectar errores de compilación antes de subir los cambios al repositorio.
* **Revisar los cambios recientes**: Revisa las confirmaciones más recientes en tu branch para identificar qué cambios provocaron el fallo de la compilación.
