---
title: "Creating a Workspace in Buuk"
url: "/help/buuk/creating-a-workspace-in-buuk"
updated: "2026-11-13T13:31:58.206Z"
---
# Creating a Workspace in Buuk

A workspace is the unit of documentation in Buuk. Every workspace has its own name, slug, branding, members, and collections, and it maps to a single public help center at `app.getbuuk.com/help/your-slug` (or a custom domain on the Growth plan). Everything you write, organize, and publish lives inside a workspace, so creating one is the first step to getting a help center live.

## What a workspace includes

- **Name and slug** — the slug determines your public URL path (`/help/your-slug`)
- **Branding** — logo, colors, and layout settings under Customize
- **Members** — owners, editors, and viewers with different publishing permissions
- **Collections** — the top-level tabs readers see, such as Documentation, FAQ, Guides, API Reference, and Changelog

## Create a workspace

1. Go to [docs.getbuuk.com/sign-up](https://docs.getbuuk.com/sign-up) and create an account, or continue with Google.
2. Complete onboarding by entering a workspace name and a slug. The slug becomes part of your public URL — for example, a workspace with the slug `buuk` is published at `/help/buuk`.
3. Choose your tabs. In Help Centre, use Manage tabs to show, rename, reorder, or remove tabs. A full site uses all five — Help, API Reference, Guides, Changelog, and FAQ — but you can keep only the ones your team needs.
4. Once onboarding finishes, your workspace opens to the dashboard, where Articles, Suggestions, Integrations, and Settings are available in the sidebar.

Starter includes a public help center and published articles at no cost, with no credit card required. Growth adds AI writing tools, more integrations, and the option to attach a custom hostname such as `docs.yourproduct.com`.

## Add your first content

A new workspace starts with an Introduction article you can edit directly, or you can create new articles from Help Centre. Use Preview in help center to see how the public layout will look before anything goes live — previewing a draft does not publish it. Pages only become visible to customers, in search, in Ask AI, and in the widget once you publish them.

For guidance on organizing content into sections and folders under each collection, see the Organize Sections and Folders article in Getting started.

## Set up members and roles

Open **Settings → Members** to invite your team to the workspace.

- **Owners** and **editors** can publish changes to the live help center.
- **Viewers** can read drafts in the dashboard without being able to change what customers see.

Invite teammates by email from this page. Assign the role that matches how much publishing control they need.

## Connect integrations

A workspace can pull in signals from the tools your team already uses. Open **Integrations** to connect sources such as Slack, GitHub, or a support inbox. Connecting an integration lets Buuk turn tickets, Slack threads, and code changes into Suggested updates you can review and accept — nothing publishes automatically. You don't need to connect every integration to start; you can begin with one source and add more later.

## Set up your public URL

Your workspace's public help center is available immediately at `app.getbuuk.com/help/your-slug`. If you rename the workspace slug later, Buuk keeps a redirect from the old `/help/old-slug` URL so existing links and bookmarks continue to resolve.

On the Growth plan, you can attach a custom hostname to the workspace instead of using the default `app.getbuuk.com` domain, so the help center appears under your own domain.

## Troubleshooting

**The workspace slug I want is unavailable.**

Slugs must be unique across Buuk. Choose a variation, such as adding your company initials, and update it later if needed — old URLs will redirect automatically.

**I can't publish changes in my workspace.**

Only owners and editors can publish. Confirm your role under Settings → Members, or ask a workspace owner to update your permissions.

**The public help center looks empty after setup.**

Confirm at least one article is published rather than left as a draft. Draft content, including the default Introduction article, stays private until you publish it.