---
title: "Slugs and redirects"
url: "/help/buuk/slugs-and-redirects"
updated: "2026-10-22T11:13:39.228Z"
---
# Slugs and redirects

Every article lives at a URL built from two slugs: the workspace's and its own — `/help/<workspace-slug>/<article-slug>`. Both come from titles, and both can be changed.

## How slugs are generated

When you save an article title, Buuk generates the slug from it: lowercase, letters, numbers, and hyphens. Slugs are unique per workspace, so a title collision appends a number — `pricing-2` — instead of silently overwriting a URL.

You can edit the slug before you publish. Edit it while the page is still a draft, and changing the title updates the slug for you before anything is public.

## Changing a slug after publish

Once an article is published, the slug is the live URL. Changing it changes the address customers have bookmarked; the old path stops resolving and there is no automatic per-article redirect.

What stays put: the article and its history, its position in the sidebar, and the rest of your links. Only that one URL changes.

If a slug must change after publishing, plan the swap: update cross-links in other articles, and — if the move matters — leave a short page at the old slug that points readers to the new address. When the change is a rename, keeping the slug and editing the title text alone is often the better trade: a stable URL is worth more than a prettier path.

## Renaming the workspace slug

The workspace slug is changed in **Settings → General**, and only workspace owners can change it. Renaming records a redirect: links starting with the old `/help/old-slug` path still find your help center at its new address.

## Slug hygiene

- Short and descriptive — three or four words a reader can recognize in search results and browser history
- Stable — a three-year-old URL is worth defending; change slugs before publishing, not after
- No dates — version drift lives in version history, not in the URL
- One kebab-case convention across the workspace, so sidebar links and cross-links read the same

> [!WARNING]
> Search engines and internal links treat a slug as a promise. Pick it once, before you share the page anywhere, and treat later changes as a migration.

## Related

- [**Write and publish an article**](./write-and-publish-an-article) — where slugs are set the first time.
- [**Organize sections and folders**](./organize-sections-and-folders) — the sidebar the slug lives under.
- [**Publish your help center**](./publish-your-help-center) — the public URL in context.