Skip to main content

Next.js fix guide

Fix Missing or vague link text on Next.js

Link purpose should be clear from text alone where possible.

Check your live page

Canonical issue page: Missing or vague link text

What this issue means

Examples

Replace “read more” with “read more about return policy”. Ensure adjacent context is programmatically associated if design requires it.

How to fix on Next.js

In Next.js, verify both server and client components: hydration can change roles/names. Use `next/image` with meaningful `alt`, and ensure dynamic imports do not drop focus management.

How to fix

Make link purpose clear from link text plus immediate programmatic context when needed.

Avoid repeated identical labels that point to different destinations.

Related: 2.4.4 Link Purpose (In Context).

Other platforms

TestAccessibility · Programmatic fix page · localhost:3001