# Despliega en una subruta con Vercel (/es/deploy/vercel)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 873 · updated: 2026-07-30 -->
Related: [Alojar la documentación en una subruta](/es/deploy/docs-subpath.md), [Despliega en una subruta con Cloudflare Workers](/es/deploy/cloudflare.md), [Despliega en una subruta con AWS Route 53 y CloudFront](/es/deploy/route53-cloudfront.md), [Proxy inverso](/es/deploy/reverse-proxy.md), [Configuración de Content Security Policy (CSP)](/es/deploy/csp-configuration.md)

Configura tu archivo `vercel.json` para reenviar mediante un proxy las solicitudes desde tu dominio principal a tu documentación en una subruta.

<div id="the-verceljson-file">
  ## El archivo vercel.json [#el-archivo-verceljson]
</div>

El archivo `vercel.json` configura cómo se compila e implementa tu proyecto. Se encuentra en el directorio raíz de tu proyecto y controla varios aspectos de la implementación, como el enrutamiento, las redirecciones, los encabezados y la configuración de compilación.

Mintlify utiliza la configuración de `rewrites` en tu archivo `vercel.json` para enrutar las solicitudes desde tu dominio principal hacia tu documentación mediante un proxy.

Las reglas de reescritura (rewrites) asignan las solicitudes entrantes a distintos destinos sin cambiar la URL en el navegador. Cuando alguien visita `yoursite.com/docs`, Vercel obtiene internamente el contenido desde `your-subdomain.mintlify.site/docs`, pero el usuario sigue viendo `yoursite.com/docs` en su navegador. Esto es diferente de las redirecciones, que envían a los usuarios a otra URL por completo.

<div id="configuration">
  ## Configuración [#configuración]
</div>

<div id="host-at-docs-subpath">
  ### Alojar en la subruta `/docs` [#alojar-en-la-subruta-docs]
</div>

1. Ve a la [configuración de dominio personalizado](https://app.mintlify.com/settings/deployment/custom-domain) en tu dashboard.
2. Habilita el interruptor **Host at**.
3. Ingresa tu dominio.
4. Ingresa `docs` como tu ruta base.
5. Haz clic en **Add domain**.
6. Agrega las siguientes reglas de reescritura a tu archivo `vercel.json`. Sustituye `[subdomain]` por tu subdominio, que se encuentra al final de la URL de tu dashboard. Por ejemplo, `app.mintlify.com/your-organization/your-subdomain` tiene un identificador de dominio de `your-subdomain`.

   ```json
   {
     "rewrites": [
       {
         "source": "/docs",
         "destination": "https://[subdomain].mintlify.site/docs"
       },
       {
         "source": "/docs/:match*",
         "destination": "https://[subdomain].mintlify.site/docs/:match*"
       }
     ]
   }
   ```

La configuración de `rewrites` asigna la subruta `/docs` en tu dominio a la subruta `/docs` en tu documentación.

* **`source`**: El patrón de ruta en tu dominio que activa la reescritura.
* **`destination`**: Adonde se debe enviar la solicitud mediante proxy.
* **`:match*`**: Un comodín que captura cualquier segmento de ruta después de tu subruta.

Para obtener más información, consulta [Configuring projects with vercel.json: Rewrites](https://vercel.com/docs/projects/project-configuration#rewrites) en la documentación de Vercel.

<div id="host-at-custom-subpath">
  ### Hospedar en una subruta personalizada [#hospedar-en-una-subruta-personalizada]
</div>

Para usar una subruta personalizada (cualquier ruta distinta de `/docs`):

1. Ve a la página de [configuración de dominio personalizado](https://app.mintlify.com/settings/deployment/custom-domain) en tu dashboard.
2. Habilita el interruptor **Host at** e ingresa tu ruta base. Por ejemplo, `/docs` o `/help`.
3. Ingresa tu dominio.
4. Ingresa tu ruta base.
5. Haz clic en **Add domain**.

Luego utiliza el generador a continuación para crear tu configuración de `rewrites` y añade las reglas de `rewrites` a tu archivo `vercel.json`.

Mintlify reconstruye tu documentación para servirla en tu ruta base, por lo que tus archivos de documentación no necesitan estar en un directorio que coincida con tu subruta.