How to fix skip link on WordPress.org

Add a valid, focusable target element (with a matching `id`) for every "Skip to main content" link so keyboard and assistive-technology users can bypass repeated navigation.

Steps for WordPress.org

  1. In wp-admin go to Appearance → Theme File Editor (or edit files locally via FTP/SSH — recommended for safety).
  2. Open header.php of your active (child) theme. Verify a skip link exists immediately after <body>: `<a class='skip-link screen-reader-text' href='#primary'>Skip to content</a>`. The exact fragment id varies by theme.
  3. Find the element in header.php, page.php, or index.php that opens the main content area and confirm it has the matching id (e.g. `<main id='primary' tabindex='-1'>`). Add the id and tabindex if missing.
  4. If you use a block theme (Full Site Editing), go to Appearance → Editor → Templates → edit the template part that wraps the Query Loop or Page Content block, switch to Code Editor view, and add the id attribute to the <main> tag.
Official WordPress.org documentation ↗

What is skip link?

A "skip link" is a hidden (but keyboard-focusable) hyperlink that sits at the very top of every page, typically labeled "Skip to main content." When activated, it jumps the user past your navigation menus straight to the page's main content area. For this to work, the link's `href` must point to an element on the same page that actually exists and can receive focus — that element is the "skip link target." When the target is missing or has no matching `id`, the skip link goes nowhere, breaking the shortcut entirely.

Keyboard-only users (people who cannot use a mouse) and screen-reader users must tab through every navigation link on every page load if no working skip link exists — on a store with 20 nav items, that means 20 extra keystrokes to reach the first product. This is a WCAG 2.1 Level A failure (Success Criterion 2.4.1 — Bypass Blocks), meaning it exposes your store to accessibility complaints, lawsuits (ADA Title III in the US, EAA in the EU, AODA in Canada), and poor audit scores. Fixing it is a quick-win code change that immediately improves usability for millions of people who rely on keyboard navigation, and signals technical quality to accessibility auditors and automated scanners alike.

See the complete Skip link guide for every platform and the full background.

Not sure if your WordPress.org store has this?

Run a free SEOLZ scan — we’ll find skip link and every other issue across your whole site.

Scan my site free

Fix skip link on another platform