mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
aeee4d4eb1
* docs: improve SEO title and descriptions for custom domain and Vercel pages * Apply suggestion from @ethanpalm * Apply suggestion from @ethanpalm --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
67 lines
3.0 KiB
Plaintext
67 lines
3.0 KiB
Plaintext
---
|
|
title: "Deploy at a subpath with Vercel"
|
|
sidebarTitle: "Vercel"
|
|
description: "Serve your Mintlify site at a subpath on your main domain using Vercel rewrites, with a step-by-step vercel.json configuration walkthrough."
|
|
keywords: ["vercel.json", "Vercel deployment", "rewrites configuration", "subpath routing"]
|
|
boost: 3
|
|
---
|
|
|
|
import { VercelJsonGenerator } from "/snippets/vercel-json-generator.mdx";
|
|
import SubpathSetupSteps from "/snippets/subpath-setup-steps.mdx";
|
|
|
|
Configure your `vercel.json` file to proxy requests from your main domain to your documentation at a subpath.
|
|
|
|
## The vercel.json file
|
|
|
|
The `vercel.json` file configures how your project builds and deploys. It sits in your project's root directory and controls various aspects of your deployment, including routing, redirects, headers, and build settings.
|
|
|
|
Mintlify uses the `rewrites` configuration in your `vercel.json` file to proxy requests from your main domain to your documentation.
|
|
|
|
Rewrites map incoming requests to different destinations without changing the URL in the browser. When someone visits `yoursite.com/docs`, Vercel internally fetches content from `your-subdomain.mintlify.site/docs`, but the user still sees `yoursite.com/docs` in their browser. This is different from redirects, which send users to another URL entirely.
|
|
|
|
## Configuration
|
|
|
|
### Host at `/docs` subpath
|
|
|
|
1. Navigate to [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) in your dashboard.
|
|
2. Enable the **Host at** toggle.
|
|
3. Enter your domain.
|
|
4. Enter `docs` as your base path.
|
|
5. Click **Add domain**.
|
|
6. Add the following rewrites to your `vercel.json` file. Replace `[subdomain]` with your subdomain, which appears at the end of your dashboard URL. For example, `app.mintlify.com/your-organization/your-subdomain` has a domain identifier of `your-subdomain`.
|
|
|
|
```json
|
|
{
|
|
"rewrites": [
|
|
{
|
|
"source": "/docs",
|
|
"destination": "https://[subdomain].mintlify.site/docs"
|
|
},
|
|
{
|
|
"source": "/docs/:match*",
|
|
"destination": "https://[subdomain].mintlify.site/docs/:match*"
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
The `rewrites` configuration maps the `/docs` subpath on your domain to the `/docs` subpath on your documentation.
|
|
|
|
- **`source`**: The path pattern on your domain that triggers the rewrite.
|
|
- **`destination`**: Where the request should be proxied to.
|
|
- **`:match*`**: A wildcard that captures any path segments after your subpath.
|
|
|
|
For more information, see [Configuring projects with vercel.json: Rewrites](https://vercel.com/docs/projects/project-configuration#rewrites) in the Vercel documentation.
|
|
|
|
### Host at custom subpath
|
|
|
|
To use a custom subpath (any path other than `/docs`):
|
|
|
|
<SubpathSetupSteps />
|
|
|
|
Then use the generator below to create your rewrites configuration and add the rewrites to your `vercel.json` file.
|
|
|
|
Mintlify rebuilds your documentation to serve at your base path, so your documentation files do not need to be in a directory that matches your subpath.
|
|
|
|
<VercelJsonGenerator />
|