Slugs

How slugs work

When you install the BookSlash extension, it registers as a search engine in your browser using the b/ prefix. When you type b/figma in the address bar and press Enter, the browser sends that query to BookSlash's edge network instead of a search engine.

BookSlash's redirect worker — running on Cloudflare's 320-point-of-presence network — resolves the slug to its destination URL and issues a 302 Found redirect. The entire round-trip takes under 40ms at p50 latency.

Creating & editing slugs

Creating a new slug

There are three ways to create a slug:

• From the app — click New slug in the sidebar or press Cmd+K and type “new slug”.
• From the extension — while on any page, click the BookSlash toolbar icon and then Save this page. The current URL and page title are pre-filled.
• From the address bar — type b/ in the address bar to open the BookSlash search overlay, then click + New slug.

Required fields

Editing a slug

Open any slug from the sidebar or search, then click the pencil icon or press E. Changes to the URL take effect within 30 seconds globally as the edge cache invalidates.

Deleting a slug

Open the slug, click the three-dot menu, and choose Delete. Deleted slugs are gone immediately. If you delete a slug that is pinned to a board, the board node turns into a broken-link state — you can re-link it to a new slug without losing the node's position.

Organizing slugs

Folders

Folders are hierarchical containers. Create them from the sidebar. Drag slugs into folders or set a folder when creating a slug. Folders do not affect the slug keyword — b/figma works the same whether it is in a folder or not.

Tags

Tags are lightweight labels for cross-folder grouping. Useful patterns:

• onboarding — all links a new hire needs on day one
• q3-launch — every URL for a specific campaign
• api — all API documentation and dashboards

Collections

Collections are curated groups of slugs that you can share as a single link. They are not hierarchical — more like a playlist. Great for onboarding docs (“here are the 10 links every engineer needs”) or per-project reference packs.

Searching slugs

Press Cmd+K (or Ctrl+K on Windows) anywhere in the app to open full-text search. Search runs across slug keywords, titles, descriptions, and tags. Results appear in under 50ms for workspaces with up to 50,000 slugs.

From the extension's address-bar overlay, the same search is one keystroke away — start typing a keyword or partial title and matching slugs appear immediately.

Custom domains

By default slugs use the b/ prefix via the BookSlash extension. On Pro and Enterprise plans you can configure a custom subdomain so your slugs resolve as, for example, go.yourco.com/figma — no extension required.

Setting up a custom domain

1. Go to Workspace Settings > Domain.
2. Enter your desired subdomain (e.g. go.yourco.com).
3. Add a CNAME record in your DNS pointing to router.bookslash.app.
4. Add a TXT record to verify domain ownership — the exact value is shown in the settings panel.
5. Click Verify. DNS propagation typically takes 2–10 minutes but can take up to 48 hours.

Custom domain limits by plan

Managing slugs via the API

Pro and higher plans have access to the REST API. You can create, update, and delete slugs programmatically — useful for syncing your tool stack during onboarding automation.

# Create a slug
curl -X POST https://api.bookslash.app/v2/slugs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"figma","url":"https://figma.com/files","title":"Figma files"}'

# Response
{
  "id": "slg_01j...",
  "keyword": "figma",
  "url": "https://figma.com/files",
  "title": "Figma files",
  "createdAt": "2026-05-05T10:00:00Z"
}

See the full API reference for all available endpoints, rate limits, and authentication details.

Redirect performance

BookSlash's redirect infrastructure runs on Cloudflare Workers across 320 points of presence worldwide. Slug resolution happens at the edge — your request never reaches an origin server.