Bio Pages
A bio page (link-in-bio) is a single public page that collects several links — perfect for the "link in bio" slot on social profiles. Each bio page lives at /bio/<slug> on your instance and is managed from the Link-in-bio screen (/bio).
Creating a Bio Page
- Open Link-in-bio from the dashboard sidebar (
/bio) - Click Create Bio Page
- Fill in:
- Slug — the public path segment (your page will be at
/bio/<slug>). Must be unique. - Title (optional) — heading shown on the page
- Theme — one of
dark(default),light,gradient, orocean
- Slug — the public path segment (your page will be at
- Click Create
Your page is live immediately at https://<your-instance>/bio/<slug>.
Adding & Ordering Links
From a bio page's editor:
- Click Add Link
- Enter the destination URL and an optional Label (the visible text)
- Set an order value to control where the link appears (lower numbers first)
- Save
Edit or remove individual links at any time; changes are reflected on the public page right away.
Themes
| Theme | Look |
|---|---|
dark | Dark background (default) |
light | Light background |
gradient | Indigo→slate gradient |
ocean | Blue gradient |
Analytics
Bio page views are tracked and can trigger the bio.viewed webhook event — see Webhooks. Clicks on individual bio links are attributed to the originating bio page.
Plan Limits
The number of bio pages per account depends on your plan (enforced only when billing is enabled — see Billing & Usage):
| Plan | Bio pages |
|---|---|
| Free | 1 |
| Starter | 3 |
| Pro | 10 |
A default self-hosted instance (BILLING_ENFORCE=false) does not enforce these limits.
Via API / MCP
Bio pages can also be managed programmatically: the GraphQL createBioPage, updateBioPage, deleteBioPage, addBioLink, updateBioLink, deleteBioLink mutations and the bioPages / bioPage queries (see Mutations), or the MCP create_bio_page, add_bio_link, list_bio_pages tools (see MCP Tools).
Next: Webhooks