Use descriptive URL slugs

Descriptive slugs help users and give crawlers a topical hint. Keep them short, lowercase, hyphenated and stable. When a slug must change, redirect the old path with a single 301 and update internal links. Avoid dates, session IDs and uppercase characters that create duplicate URLs.

lowIn codeimpact effort

Why this matters

A readable path beats an ID, and changing it needs a 301.

Get the full breakdown

The extended brief explains when this works, when it does not, and the trade-offs. Join the waitlist and it unlocks for every tip when sign-in opens; MCP access is the paid part.

Join the waitlist

Before you start

  • Control over routing or CMS permalink settings

How to apply it

  1. Audit existing slugs General best practice

    Crawl the site and flag slugs with uppercase letters, underscores, IDs, dates or more than four path segments. Rank by traffic and inbound links.

    Check: The audit lists every non-conforming slug with its traffic and inbound link count.

  2. Change only high-value slugs General best practice

    Rewrite slugs that are unreadable or misleading. Keep stable slugs that already rank; the benefit of a cosmetic change is smaller than the redirect risk.

    Check: Every changed slug has a matching 301 entry and updated internal links in the same commit.

  3. Verify the redirect and index state

    Confirm the old path returns one 301 to the new path and that the new URL is canonical and listed in the sitemap.

    Check: curl -sI your production domain/old-slug returns 301 with Location equal to the new slug.

Get the prompt for your agent

A ready-to-paste prompt for your agent that implements this tip and verifies the result in your repo.

Join the waitlist

Source: seo-mcp playbook · curated entry · report an error

Framework notes

nextjs-app

Use `[slug]` route segments and `generateStaticParams` from the CMS slug field; keep the slug immutable in the CMS after publish.

wordpress

Set the permalink structure to `/%postname%/` and install a redirect plugin before bulk-changing existing post names.

Official references

Let your agent apply this + 161 more tips.

Pre-order — $19