React Router route changes: update the page title and move focus to the new heading


The front-end developer who updates the page title on each React Router route has fixed one cue out of three. A full page load also put focus at the top and gave screen readers a new page to announce. React Router skips that load and leaves both jobs to the app. One focus call, on the new heading, does both: keyboard users start there, and screen readers read it.
From the link to the two-minute test
#What happens when a React Router link changes the page?
A screen reader says nothing after a React Router link because there is no page load to announce: the link swaps the view in place. The browser tab keeps its old title, focus never returns to the top, and screen readers get no page load to announce, a moment VoiceOver has a setting for. People who use the keyboard or a screen reader rely on the last two.
React Router's accessibility page lists focus management and announcements as things to consider, with no code, in a section for its framework mode. Our demo runs React Router 8.5.1 in declarative mode, the plain <BrowserRouter> setup. It is the member app of Wild Rye Farm Share, a vegetable box subscription, where a keyboard user opens “Deliveries” to skip next week's box.
Three presses go through the logo and “This week” to “Deliveries”.
The view becomes “Your deliveries”. Focus stays on the link, and the browser tab still reads “Wild Rye Farm Share”.
Focus moves on to “Add-ons”, still in the header.
WebKit, Safari's engine, gave the same count with Option+Tab, since its plain Tab skips links. A link inside the old view fares better: “See past deliveries” vanishes with its view, focus falls back to the page, and the next press lands in the new view, on “Rate this box”.
A screen reader user who follows “Deliveries” may not learn that the page changed, as the 2019 user research cited in React Router's docs warns.
#How to change the page title and move focus on each React Router route?
Give each route its own <title>, then move focus to the new view's main heading.
#How to set the page title for each route?
Render a <title> in each route component: React 19 places it in the head from anywhere in the tree. React Router 8 needs React 19.2.7 or later and no longer ships react-router-dom. Import from react-router, which version 7 accepts too.
const SITE = "Wild Rye Farm Share";
function Deliveries() {
return (
<section>
<title>{`Deliveries | ${SITE}`}</title>
<h1>Your deliveries</h1>
{/* the filter and the list of boxes */}
</section>
);
}React wants a single string inside <title>. On our demo, <title>{name} | Wild Rye Farm Share</title> gave it two pieces, and the title came out empty, with no console warning. A template literal makes one string.
Keep one <title> at a time: none in the layout. WCAG's Page Titled guidance names single-page apps and asks for a page title that follows the view.
#Where focus should go after a route change?
WCAG leaves the choice to you: Focus Order only asks that the order let people understand and operate the page, and both patterns below do. Of the targets the 2019 user research tried, its screen reader testers liked the heading best: it would save time and make clear what happened.
After a retest, its final advice differs: a skip link that takes focus on each route change. A live region, an element whose new text screen readers read out, is present from page load and names the new page. On its magnification tester's phone, focusing a heading or wrapper much wider than the screen scrolled the view to its middle, cutting off both ends of the text. Samsung's Chrome seemed partly to blame. What suits one user with a disability, the research's author adds, may not suit another.
#Why we recommend focusing the heading?
We still recommend the h1, provided it fits a phone screen: on Wild Rye, “Your deliveries” takes 310 of 360 pixels, on one line. One move puts keyboard users at the start of the new content and gives screen readers its heading. MDN adds that live regions can behave differently across browser and screen reader pairs, and likely don't suit a change that moves focus.
Declarative mode has no ScrollRestoration to reset the scroll, so in a phone-sized window the bare app opened “Past deliveries” with its heading over 200 pixels above the screen. focus() fixes that: it scrolls the heading into view.
On the focused heading, the app's :focus-visible outline shows in Chrome after Enter only, in WebKit after a click too. Keep it: the sighted 2019 testers found visible focus useful, though one added that outlines on elements that do nothing can confuse. The voice control tester spotted the outline more easily on a heading than on a wide wrapper. Our :focus-visible guide covers the style.
Focus visible: how to style the focus indicator in CSS
#When a skip link and a live region work better?
Pick the 2019 research's pattern when views can't promise an h1 on render: a view behind a loading screen, a dashboard with none. Focus lands on a working skip link in the view, like the research's “skip to main navigation”, and nothing wide receives it. On Wild Rye, a top-of-page “Skip to main content” link costs one more key: Enter on it, then Tab, reaches “Find a delivery”.
It has two parts to maintain, and the live region must exist from the first render, in the app shell. Pick one pattern: a focused heading plus a region repeating its name would give screen readers that name twice.
How to add a skip link: the HTML code and the keyboard test
#How to write the focus hook?
The focus code is a small hook, called in the layout that renders <Outlet /> inside <main>. React runs effects after the new view is in the page.
Keyed on the location, as in React Router's own useLocation example, that hook broke Wild Rye's filter. The location includes the query string and hash, and the filter writes its text to the URL as ?q=: the first letter typed counts as a navigation. After “k”, focus jumped to the heading, and “ale” went nowhere, with the mouse as with the keyboard. Keyed on the pathname, the hook ignores the filter.
Avoid
Marker 1. The heading “Your deliveries”, which took focus after the first letter. Marker 2. The “Find a delivery” field, holding only the letter k.const location = useLocation();
const previous = useRef(location);
useEffect(() => {
if (previous.current === location) return;
previous.current = location;
// focus the new h1
}, [location]);Correct
Marker 2. The “Find a delivery” field, still focused, with the whole word kale typed.const { pathname } = useLocation();
const previous = useRef(pathname);
useEffect(() => {
if (previous.current === pathname) return;
previous.current = pathname;
// focus the new h1
}, [pathname]);The pathname comparison also leaves the first load to the browser. A “first run” boolean looks equivalent, but Strict Mode runs effects one extra time in development. On our demo, the boolean version sent focus to the heading on every load and reload in development, never in production.
The hook gives the heading tabindex="-1": a script can focus it, and Tab skips it. A view without an h1 falls back to <main>, which “worked okay” for the 2019 screen reader testers, though far less noticeable than a heading.
import { useEffect, useRef } from "react";
import { Outlet, useLocation } from "react-router";
export function useFocusOnRouteChange() {
const { pathname } = useLocation();
const previous = useRef(pathname);
useEffect(() => {
if (previous.current === pathname) return;
previous.current = pathname;
const target =
document.querySelector("main h1") ?? document.querySelector("main");
if (!target) return;
if (!target.hasAttribute("tabindex")) target.setAttribute("tabindex", "-1");
target.focus();
}, [pathname]);
}
export function Layout() {
useFocusOnRouteChange();
return (
<>
<Header />
<main>
<Outlet />
</main>
</>
);
}#How to test a React Router route change with the keyboard and VoiceOver?
Each route takes about two minutes: four keys in the browser, then the same link with VoiceOver on. On a Mac, Safari's Tab skips links until “Press Tab to highlight each item on a webpage” is on in its Advanced settings, and buttons until Keyboard Navigation is on in macOS.
Three presses reach “Deliveries”.
Focus moves to “Your deliveries”, and the browser tab reads “Deliveries | Wild Rye Farm Share”.
One press reaches “Find a delivery”.
Focus stays in the field, and the list narrows from five boxes to three.
Then turn on VoiceOver with Command+F5 and follow the same link; Control pauses its speech. The new heading should be spoken once: silence or the name said twice means the hook needs another look. Our runs had no screen reader, so the listening part is for a real Mac.
VoiceOver is the reader on a developer's Mac, but only 6.5% of respondents to WebAIM's 2026 screen reader survey use it as their main desktop reader. Nine in ten use Windows, so repeat the check with NVDA.
With the title and focus back, a keyboard user skips next week's box in four keys from “Deliveries”: Enter, Tab twice, then Enter on Thursday, November 19, whose button now reads “Box skipped”. The bare app took seven, through “Add-ons”, “Recipes” and “Account” first.
NVDA screen reader: how to install it, set it up and test a web page
Includdy analyzes the page on screen and can add it to a snapshot, a dated analysis of the site's pages. Its manual checks there ask whether the page title describes the page and whether each visible heading, the focused h1 included, is marked as one.


