---
title: "Rewrite docs to Mintlify"
description: "Learn how to rewrite the /docs path on your domain to Mintlify, a popular documentation platform."
url: "https://vercel.com/templates/next.js/rewrite-docs-to-mintlify"
links:
  repository: "https://github.com/vercel/examples/tree/main/cdn/mintlify-docs-rewrite"
  demo: "https://mintlify-docs-rewrite.vercel.app/"
  deploy: "https://vercel.com/new/clone?demo-title=Rewrite+docs+to+Mintlify&demo-description=Learn+how+to+rewrite+the+%2Fdocs+path+on+your+domain+to+Mintlify%2C+a+popular+documentation+platform.&demo-url=https%3A%2F%2Fmintlify-docs-rewrite.vercel.app%2F&demo-image=%2F%2Fimages.ctfassets.net%2Fe5382hct74si%2F74xecdGtFvUrACZIuNqxQK%2Ffd328dfa4bd5bbdcaf44002014ddfc31%2FScreenshot_2026-01-21_at_11.29.49%C3%A2__AM.png&project-name=Rewrite+docs+to+Mintlify&repository-name=rewrite-docs-to-mintlify&repository-url=https%3A%2F%2Fgithub.com%2Fvercel%2Fexamples%2Ftree%2Fmain%2Fcdn%2Fmintlify-docs-rewrite&from=templates&skippable-integrations=1&root-directories=List+of+directory+paths+for+the+directories+to+clone+into+projects&project-names=Comma+separated+list+of+project+names%2Cto+match+the+root-directories"
---

# Rewrite docs to Mintlify

Learn how to rewrite the /docs path on your domain to Mintlify, a popular documentation platform.

# Mintlify docs rewrite (vercel.ts) example

This template demonstrates how to serve Mintlify-hosted documentation from your main domain using Vercel's `vercel.ts` configuration. Instead of linking to `docs.yourdomain.com` or an external URL, your docs are seamlessly integrated at `/docs` on your product site.

The demo shows a fictional product site ("Flux") with docs hosted on Mintlify but served from the main domain for a unified user experience.

## Demo

https://mintlify-docs-rewrite.vercel.app/

Visit the docs at `/docs` to see the Mintlify-hosted site served through the main domain.

## How to Use

You can choose from one of the following two methods to use this repository:

### One-Click Deploy

Deploy the example using [Vercel](https://vercel.com?utm_source=github&utm_medium=readme&utm_campaign=vercel-examples):

[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/vercel/examples/tree/main/cdn/mintlify-docs-rewrite&project-name=mintlify-docs-rewrite&repository-name=mintlify-docs-rewrite&env=MINTLIFY_DOCS_URL)

### Clone and Deploy

Execute [`create-next-app`](https://github.com/vercel/next.js/tree/canary/packages/create-next-app) with [npm](https://docs.npmjs.com/cli/init) or [Yarn](https://yarnpkg.com/lang/en/docs/cli/create/) to bootstrap the example:

```bash
pnpm create next-app --example https://github.com/vercel/examples/tree/main/cdn/mintlify-docs-rewrite
```

Next, run Next.js in development mode:

```bash
pnpm dev
```

## Environment variables

- `MINTLIFY_DOCS_URL` – Your Mintlify custom domain URL (e.g., `https://your-subdomain.mintlify.dev`)

Set this in your Vercel project settings or in a `.env.local` file.

## How it works

1. You configure a custom domain in Mintlify (e.g., `your-subdomain.mintlify.dev`)
2. `vercel.ts` exports a config with rewrite rules that map `/docs` and `/docs/:match*` to your Mintlify URL
3. Vercel applies these rewrites at the edge, transparently proxying requests to Mintlify while preserving the original URL in the browser
4. Users visit `yourdomain.com/docs` and see your Mintlify documentation as if it's part of your main site

## Key benefits

- **Better SEO**: Docs are on your main domain, not a separate subdomain
- **No CORS issues**: Content is served from your domain
- **Seamless branding**: Consistent experience across product and docs
- **Simple setup**: Just add environment variable and deploy
- **Mintlify handles infrastructure**: Focus on content while Mintlify manages hosting, CDN, and updates

---

## Additional documentation

The [Vercel Knowledge Base](https://vercel.com/kb) contains guides and answers to common questions about Vercel, including deployment, framework configuration, domains, caching, and troubleshooting.