Slugs and browserSlugs overview

Slugs overview

What bookmark slugs are, how /go/ forwarding resolves a slug to a bookmark, and how slugs connect to browser shortcuts.

What you get from slugs

A slug is a short keyword you attach to a bookmark. When Enable Forwarding is on and a slug is set, SlugBase can send visitors from a short path to that bookmark’s URL. The usual pattern is /go/ followed by your slug on your SlugBase site (for example https://your-server.example/go/docs).

Self-hosted SlugBase uses the same slug and forwarding behavior as the core app. You run both the web UI and the API that serves GET /go/:slug.

How slugs appear in the app

IdeaIn the UI
Keyword fieldSlug on the bookmark form
Optional shortcutHint: Leave empty if you don't need a custom slug
Turn forwarding onEnable Forwarding (a slug is required when forwarding is enabled)
UniquenessSlug already exists. Slugs must be unique across all bookmarks.

Each slug must be unique across the whole self-hosted instance. If you try to save a slug that is already in use, you'll see the message Slug already exists. Slugs must be unique across all bookmarks.

On SlugBase Cloud, each organization has its own slug space, so different organizations can use the same slug without conflict.

If you ever see a page asking you to choose between multiple matching bookmarks, use Go preferences to save your preferred choice.

Opening a bookmark by slug

  • Address bar or link: Visit /go/ plus your slug on your SlugBase origin (same shape as …/go/docs). You must be signed in; if you are not, you are redirected to login and then back to that path.
  • Command palette: Open the palette (Ctrl+K / ⌘K). Type go and a space, then the slug (or paste a path that starts with /go/). Results appear under Go; Enter opens the forwarding URL for that slug.

The dashboard Quick access section highlights bookmarks you open most often via these shortcuts (Shortcut / Domain metadata).

Set up your browser’s address bar

To type a keyword (for example go), a space, and your slug—like a search engine—follow Browser setup. That guide matches the in-app Custom Search Engine Setup Guide (/search-engine-guide).