Files
vercel__next.js/errors/invalid-new-link-with-extra-anchor.mdx
T
Hendrik Liebau 4b66771895 Remove deprecated legacyBehavior and passHref prop from Link component (#83003)
The `legacyBehavior` prop of the `Link` component has been deprecated
since #77473. For Next.js 16, we're finally removing support for it.
Consequently, we're also removing support for the `passHref` prop, which
was only useful in conjunction with the `legacyBehavior` prop.

A [codemod is
available](https://nextjs.org/docs/app/guides/upgrading/codemods#new-link)
to help you automatically upgrade your codebase.

reverts #77473

---------

Co-authored-by: Sebastian Sebbie Silbermann <sebastian.silbermann@vercel.com>
2025-08-26 14:04:27 +02:00

22 lines
546 B
Plaintext

---
title: 'Invalid `<Link>` with `<a>` child'
---
## Why This Error Occurred
Starting with Next.js 13, `<Link>` renders as `<a>`, so attempting to use `<a>` as a child is invalid.
## Possible Ways to Fix It
Run the `new-link` codemod to automatically upgrade previous versions of Next.js to the new `<Link>` usage:
```bash filename="Terminal"
npx @next/codemod new-link .
```
This will change `<Link><a id="link">Home</a></Link>` to `<Link id="link">Home</Link>`.
## Useful Links
- [next/link](/docs/pages/api-reference/components/link)