Workspace admin

Admin: AI suggestions

Enable OpenAI-powered bookmark suggestions in self-hosted SlugBase: admin toggle, API key, model selection, and user preferences.

What this is for

AI Suggestions (sidebar under Admin) configures optional AI help when people create bookmarks: suggested title, tags, and slug. The page title in the app is AI Bookmark Suggestions; the UI copy states that it uses OpenAI (for example GPT-4o-mini in the default description text).

Before you start

You need access to Admin (see Workspace admin overview).
Self-hosted builds show the full form: Enable AI suggestions, Provider (OpenAI), API Key, and Model. Obtain an API key from your OpenAI account.

Self-hosted vs cloud: On your own server, plan information from /config/plan is not used; the AI Suggestions item stays available to admins. On the hosted product, whether this page appears and what you can edit may depend on subscription and deployment settings.

How to turn on AI and set credentials

Open AI Suggestions

Under Admin, choose AI Suggestions.

Enable

Turn on Enable AI suggestions. The app saves this change when you toggle it.

Provider

Choose Provider (OpenAI is available in the selector).

API key

Paste your API Key. The field saves on blur when you enter a non-empty value. To rotate keys, enter a new key; when a key is already stored, the placeholder explains that you can enter a new key to change it.

Model

After a key is set and saved, open Model to pick from models returned by the server. If the list is still loading, wait for Loading models… to finish; if loading fails, check the key and try again.

User-level control

When the instance exposes AI suggestions (backend reports they are available), each user sees AI suggestions under Preferences on Profile and preferences so they can opt in or out for their own account. That preference only matters if an administrator has enabled suggestions for the instance.

Verify

With AI enabled and a valid key, create a bookmark and confirm suggestions appear during creation (the bookmark UI shows an AI-suggesting state while working).
If AI is not available from the server yet, the profile AI suggestions toggle stays hidden until admin configuration succeeds.

Troubleshooting

Configuration

Notes on AI env vars vs in-app setup for self-hosted installs.

Bookmarks

Creating and managing bookmarks where suggestions apply.

Was this page helpful?

Last updated 3 days ago

Built with Documentation.AI