> ## Documentation Index
> Fetch the complete documentation index at: https://help-center-starter-replace-template-content.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Vercel deployment

> Deploy your Mintlify docs on Vercel for custom routing and edge performance.

You can deploy a Mintlify docs site as a Next.js project on Vercel. This gives you full control over routing, redirects, and CDN configuration.

## When to use Vercel

Use Vercel hosting when you:

* Need to serve docs from a path on your own domain (for example, `yourdomain.com/docs`).
* Want to use Vercel's edge network for CDN and performance.
* Need custom middleware for authentication or routing.

For most teams, Mintlify's built-in hosting with a custom subdomain (`docs.yourdomain.com`) is simpler and requires no additional infrastructure.

## Setup overview

<Steps>
  <Step title="Export your Mintlify project">
    Use the Mintlify CLI to export your project as a Next.js static build:

    ```bash theme={null}
    mintlify build
    ```
  </Step>

  <Step title="Deploy to Vercel">
    Push the build output to a Git repository connected to Vercel, or use the Vercel CLI:

    ```bash theme={null}
    vercel deploy
    ```
  </Step>

  <Step title="Configure your domain">
    In the Vercel dashboard, add your custom domain under **Project → Settings → Domains**.
  </Step>
</Steps>

<Note>
  When deploying to Vercel, you manage your own hosting infrastructure. Mintlify's built-in analytics and AI search features may behave differently in this configuration — check the [Mintlify docs](https://mintlify.com/docs) for any limitations.
</Note>