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

1. Export your Mintlify project

   Use the Mintlify CLI to export your project as a Next.js static build:

   mintlify build
   
2. Deploy to Vercel

   Push the build output to a Git repository connected to Vercel, or use the Vercel CLI:

   vercel deploy
   
3. Configure your domain

   In the Vercel dashboard, add your custom domain under Project → Settings → Domains.

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 for any limitations.