Error AtlasError Documentation and Resolution
Back to searchMore Next.js errors

Next.js

Next.js Link wrapper is missing passHref

Link `passHref`

Next.js detected a Link wrapping a custom anchor-like component without passHref, which prevents the child anchor from receiving the href attribute.

Link passHrefruntime

Observed message

Link `passHref`

Why it happens

  • A custom component wrapping an anchor is used inside next/link without passHref.
  • A styled anchor component is nested under Link but does not receive href.
  • Legacy Link behavior is being used without the compatibility props.

How to fix it

  1. Add passHref to the Link when it wraps a custom anchor-like component.
  2. Use legacyBehavior when required for compatibility with child anchor patterns.
  3. Confirm the custom component forwards anchor props correctly.

Official reference

Next.js Docs: Link passHref

Related errors

href Interpolation FailedNext.js href interpolation failed for a dynamic routeInvalid href passed to routerNext.js invalid href passed to Link or routerNo Router InstanceNext.js router method called during prerenderingNextRouter was not mountedNext.js useRouter was used without a mounted Next router

Explore more

Next.jsBrowse more Next.js errorsruntimeBrowse more runtime errors
Next.js Link passHref error: causes and fixes | Error Atlas