Maaz Zindani

Loading the index…

↑↓ move↵ openesc close4072 pages
Next.js and React

React-Bootstrap Navbar links reload the page or do not route

ErrorClicking a Navbar link reloads the whole page

Short answer

Nav.Link renders a normal anchor when you give it href, so the browser loads a new page and React Router never sees the click. Render the router's Link through the as prop and pass to, not href. Use NavLink for the active style, and collapseOnSelect to close the mobile menu.

  • Applies to react-bootstrap 2, react-router 7, React 19
  • Updated
  • By Maaz Zindani, Senior Software Engineer

Fix it fast

  1. 1Find out which cause you have

    Open the browser network tab and click a Navbar link. If a document request for the page appears, the link is a plain anchor and bypasses the router.

    grep -rn "Nav.Link\|Navbar.Brand" src/
  2. 2Match what you see, then jump to its fix

    1. 1A full document request on every clickhref on Nav.Link or Navbar.Brand makes a normal browser linkFix
    2. 2Routing works but no item looks selectedThe active link is not highlightedFix
    3. 3On a narrow screen the open menu covers the new pageThe collapsed menu does not close after a link is chosenFix

What does the error look like?

  • Clicking a Navbar link reloads the whole page
  • The URL changes but the route component does not
  • The mobile menu stays open after you pick a link

Cause 1 of 3

href on Nav.Link or Navbar.Brand makes a normal browser link

1Check

The React-Bootstrap docs show Nav.Link and Navbar.Brand taking href. That is a standard link, so the browser navigates itself. React Router's Link is the component that does client-side routing.

grep -rn "href=" src/components/Header.jsx

2Fix

Use the as prop to render React Router's Link and pass the path in to.

import { Link } from "react-router";
<Navbar.Brand as={Link} to="/">Home</Navbar.Brand>
<Nav.Link as={Link} to="/about">About</Nav.Link>

3Verify

Clicking a link changes the URL and shows the new route without a document request.

// network tab: no new document request

Confirmed by reactrouter.com

Did this fix it?

Cause 2 of 3

The active link is not highlighted

1Check

A plain Link has no active state. NavLink wraps Link and adds an active class and aria-current="page" to the current link.

document.querySelector("a.active")

2Fix

Render NavLink through as. Without end, /tasks is also active on /tasks/123; add end to match only the exact path.

import { NavLink } from "react-router";
<Nav.Link as={NavLink} to="/tasks" end>Tasks</Nav.Link>

3Verify

The current item gets the active class and aria-current.

document.querySelector('a[aria-current=page]')

Confirmed by reactrouter.com

Did this fix it?

Cause 3 of 3

The collapsed menu does not close after a link is chosen

1Check

The navbar collapses only when told to. React-Bootstrap offers collapseOnSelect for this, and the docs example sets it together with the expand prop.

grep -n "collapseOnSelect" src/components/Header.jsx

2Fix

Set collapseOnSelect on Navbar.

<Navbar collapseOnSelect expand="lg">
  <Navbar.Toggle aria-controls="basic-navbar-nav" />
  <Navbar.Collapse id="basic-navbar-nav">
    <Nav><Nav.Link as={Link} to="/about">About</Nav.Link></Nav>
  </Navbar.Collapse>
</Navbar>

3Verify

On a phone-width window, choosing a link closes the menu.

// resize the window below the lg breakpoint

Confirmed by react-bootstrap.github.io

Did this fix it?

How do I stop it coming back?

  • Treat href as a browser link and to as a router link.
  • Keep all navbar items on one pattern: Nav.Link with as.
  • Use NavLink with end where a parent path should not stay active on child pages.

Sources

How was this page made?

I drafted this page with AI assistance from the official documents listed under Sources. Every cause above names the document that confirms it. I have not reproduced this fix on a machine of my own yet, so read it as documented guidance, not a test report. Found a mistake? Tell me.

Which stack is behind this page?

Projects of mine built on the same technologies:

Related fixes

Next step

Want this handled for good?

I look after servers, apps and releases end to end. Tell me what keeps breaking.