rsnext/errors/invalid-external-rewrite.mdx

---
title: Invalid External Rewrite
---

## Why This Error Occurred

A rewrite was defined with both `basePath: false` and an internal `destination`. Rewrites that capture urls outside of the `basePath` must route externally, as they are intended for proxying in the case of incremental adoption of Next.js in a project.

## Possible Ways to Fix It

Look for any rewrite where `basePath` is `false` and make sure its `destination` starts with `http://` or `https://`.

## Useful Links

- [Rewrites section in Documentation](/docs/pages/api-reference/next-config-js/rewrites)
docs: Migrate error messages to MDX and App Router. (#52038) This PR is part of a larger effort to migrate error messages to MDX and use App Router: https://github.com/vercel/front/pull/23459 2023-07-05 15:11:16 +02:00			`---`
			`title: Invalid External Rewrite`
			`---`
Disallow basePath: false for internal routes (#15837) 2020-08-04 19:50:09 +02:00
docs: Migrate error messages to MDX and App Router. (#52038) This PR is part of a larger effort to migrate error messages to MDX and use App Router: https://github.com/vercel/front/pull/23459 2023-07-05 15:11:16 +02:00			`## Why This Error Occurred`
Disallow basePath: false for internal routes (#15837) 2020-08-04 19:50:09 +02:00
			A rewrite was defined with both `basePath: false` and an internal `destination`. Rewrites that capture urls outside of the `basePath` must route externally, as they are intended for proxying in the case of incremental adoption of Next.js in a project.

docs: Migrate error messages to MDX and App Router. (#52038) This PR is part of a larger effort to migrate error messages to MDX and use App Router: https://github.com/vercel/front/pull/23459 2023-07-05 15:11:16 +02:00			`## Possible Ways to Fix It`
Disallow basePath: false for internal routes (#15837) 2020-08-04 19:50:09 +02:00
			Look for any rewrite where `basePath` is `false` and make sure its `destination` starts with `http://` or `https://`.

docs: Migrate error messages to MDX and App Router. (#52038) This PR is part of a larger effort to migrate error messages to MDX and use App Router: https://github.com/vercel/front/pull/23459 2023-07-05 15:11:16 +02:00			`## Useful Links`
Disallow basePath: false for internal routes (#15837) 2020-08-04 19:50:09 +02:00
docs: Migrate error messages to MDX and App Router. (#52038) This PR is part of a larger effort to migrate error messages to MDX and use App Router: https://github.com/vercel/front/pull/23459 2023-07-05 15:11:16 +02:00			`- [Rewrites section in Documentation](/docs/pages/api-reference/next-config-js/rewrites)`