logo
Slugs and browserBrowser setup
Slugs and browser

Browser setup

Add SlugBase as a custom search engine so you can type go plus your bookmark slug in the address bar (Chromium-based browsers and Firefox).

What you will have done

Your browser will use a custom search engine (or one-click search engine) whose URL template points at your SlugBase site’s /go/ path. Then you can type your chosen keyword (the in-app guide suggests go), a space, and a bookmark slug—same rhythm as a normal search—and press Enter to open that bookmark.

The canonical forwarding endpoint is GET /go/:slug on your SlugBase server. The SPA route /go/:slug hands off to that backend URL (in local development the UI may target the API port; in a normal deployment it follows your configured base URL).

Before you start

  • You need at least one bookmark with a Slug and Enable Forwarding set if you want a real shortcut to resolve.
  • Know your SlugBase origin (for example https://bookmarks.example.com). The template always uses that host plus /go/%s (literal %s is replaced by the browser with whatever you type after the keyword).

SlugBase ships a step-by-step UI that fills in Your Search URL for your current site:

Go to Bookmarks

Open Bookmarks from the sidebar.

Open the Search engine guide

Use Learn how to set up a custom search engine where it appears on the bookmarks page, or from the Overview dashboard choose Set up browser search engine shortcut (onboarding). Both go to /search-engine-guide (Custom Search Engine Setup Guide).

Pick your browser family

Toggle Chromium-based (Chrome, Edge, Brave, etc.) or Firefox and follow Step 1Step 5 on that screen.

URL template to enter manually

If you are not logged into the app, use this pattern (replace the origin with yours):

https://YOUR-SLUGBASE-ORIGIN/go/%s

How It Works (in-app copy): you type a keyword (like go), a space, then your bookmark slug in the address bar—Your Search URL is the template; %s is replaced by your slug.

When adding the engine, the guide suggests:

  • Name: SlugBase (or any name you prefer)
  • Keyword: go (or any keyword you prefer)
  • URL: the …/go/%s line shown as Your Search URL

Verify

After setup, try the Usage Example from the guide: type go test (replace test with a slug you created) and confirm you land on the right bookmark (Replace 'test' with any bookmark slug you've created in SlugBase!).