Skip to content
webappsysv36the production system behind Adapte DijitalEN · TR · built in Istanbul
Order a site
  1. WebAppSys
  2. Notes
  3. URL Slugs: Short, Readable and Permanent

publish06-url-slugs-best-practices.md

URL Slugs: Short, Readable and Permanent

How to write URL slugs that people can read and that never need changing: lowercase, hyphens, no dates, few words, and what to do when one must change.

read
~4 min
updated
2026-11-19
type
guide
by
webappsys
cover.webp
URL Slugs: Short, Readable and Permanent

A slug is the readable part of a page address, such as /url-slugs-best-practices/. Good slugs are lowercase, use hyphens between words, contain three to six meaningful words, avoid dates and avoid special characters. Most importantly, they are permanent: once a page is published, change its slug only with a redirect.

The slug is a small detail that lasts for the life of a page. It appears in search results, in shared links and in every internal link on your site. A good one helps people understand where a link goes before they click it. A bad one is hard to fix later, because every link that points to it must be redirected. This note is part of the website production system README.

The rules we use

  • LowercaseAvoids duplicate addresses that differ only in capital letters.
  • HyphensSeparate words with hyphens, not underscores or spaces.
  • ShortThree to six meaningful words is usually enough.
  • No stop wordsWords such as "the", "and" or "how to" can usually go.
  • No datesA date makes evergreen content look out of date.
  • Plain lettersReplace accented and special characters with plain letters.

Google's own guidance recommends simple, descriptive URLs and hyphens to separate words. See its Search Central documentation on URL structure for the current wording.

From title to slug

  1. Start with the page title.
  2. Remove words that add no meaning: articles, conjunctions, filler.
  3. Keep the main topic and one qualifier.
  4. Convert to lowercase and replace spaces with hyphens.
  5. Check it is unique on the site.

For example, "How to Write a Website Brief a Provider Can Build From" becomes /website-brief/ or /write-website-brief/. The snippet preview suggests a slug from any title, which you can then shorten by hand.

Non-English characters

Letters such as ç, ş, ğ, ü or é are allowed in modern addresses, but they are often encoded into long strings of percent signs when copied and pasted. For predictable links, convert them to plain letters: ç to c, ş to s, ü to u. Do this the same way across the whole site so links stay consistent.

Pages and posts must not collide

On WordPress, a page and a post can end up competing for the same address. Plan slugs for pages and articles together, and keep a list. Our content compiler checks that every slug in a set is unique before anything is installed.

Changing a slug after launch breaks every link to the old address unless you add a redirect. Shared links, bookmarks and search results keep pointing to the old one for a long time.

When a slug must change

Sometimes a change is unavoidable: a product is renamed or a page merges with another. Then set up a permanent (301) redirect from the old address to the new one, update your internal links to point directly to the new address and resubmit the sitemap. Avoid chains where one redirect leads to another. Finding links that still point to old addresses is covered in broken internal links.

Folders and categories

Some sites put categories in the address, such as /topic/article-name/. This can help on large sites, but it makes addresses longer and ties articles to a category you may later change. For small and medium sites, a flat structure with just the slug is simpler and more stable.

How this fits the system

Slugs are set in every content file and checked for uniqueness by the compiler. They work together with the title and description, covered in title tags and meta descriptions. The full route is in the website content pipeline.

Choose a short, lowercase, hyphenated slug before you publish, and then leave it alone. A permanent address is worth more than a clever one.

Frequently asked questions

Should the slug include my main keyword?

Usually yes, because it describes the page. Do not repeat it or add extra keywords.

Is a trailing slash important?

Pick one style and use it everywhere. WordPress uses a trailing slash by default.

Can I use numbers?

Yes, when they are part of the topic, such as a model number. Avoid years for evergreen content.

General information, not legal or financial advice. Search engines and platforms change their rules; check their official documentation before relying on any detail.

// Same branch

Related notes