# BlueHill Wiki: user guide

> Source: https://support.usebluehill.com/wiki-overview  |  Updated: 2026-10-27T15:21:53Z

## What the wiki is

The wiki is where your team writes down how it works. Every page lives in a knowledge base and, if you like, in a folder or under a parent page. Pages start as drafts, are published when they are ready, and keep every saved version so nothing is lost. Teammates can comment on a passage, mention each other, link a page to a board task or a support ticket, and share a page with the whole workspace or with a few people.

A knowledge base can also be made public. Its published pages then appear on your customer help center as articles. You write and manage those articles in the same wiki; the help center's own dashboard, publish bar, categories, domains and reviews are covered in the Help Center guides.

## Key terms

| Term | Meaning |
|---|---|
| **Page** | One document in the wiki. A page has a title, an optional description, a web address (its *slug*), a status and a body you edit in the editor. |
| **Knowledge base** | A separate workspace inside the wiki. Every page belongs to exactly one. An *internal* knowledge base is for your team; a *public* one is served on your help center. |
| **Folder** | A container for pages inside a knowledge base. Folders can nest. On the help center a folder is shown as a category. |
| **Subpage** | A page nested under another page, its *parent page*. Subpages show indented under their parent in the sidebar tree. |
| **Draft** / **Published** / **Archived** | A page's status. Drafts and archived pages carry a chip in the tree and the list; published pages carry none. |
| **Pin** | A page kept at the top of the Wiki page. **My pins** are yours alone; **Pinned** pages are pinned for everyone. |
| **Owner** | A teammate responsible for a page, listed under **People** in its details. Owners can edit, share and publish it. |
| **Visibility** | Who can open a page: **Everyone in org**, **Team**, **Specific people** or **Private**. |
| **Permission** | What a person or team can do on a page: **View**, **Comment** or **Edit**. |
| **Tag** | A label such as *#runbook* that you can put on any page and browse by. Tags can be grouped, for example by *Type* or *Owner*. |
| **Version** | A snapshot of the page taken every time it is saved. Versions can be compared and restored. |
| **Comment** | A note attached to a passage or to the whole page. A *change request* is a comment that asks for a specific fix. |
| **Review** | An approval from a teammate. A knowledge base can require an approved review before a page is published. |
| **Backlink** | A page that links to the page you are reading. Pages link to each other with `[[` links. |
| **Help center** | The public website built from your public knowledge bases. See the Help Center guides. |

## Where to find the wiki

- **Navigation → Wiki** opens the Wiki page, the home of your internal pages.
- Press **⌘K** (or **Ctrl+K**) anywhere in BlueHill to search. Wiki pages are listed under **Wiki pages**; type *w:* before your search to look only in the wiki.
- **Analytics → Knowledge base** opens the help center analytics. It is covered in the Help Center guides.
- On a board, a task's **Wiki** tab and the **Wiki** column hold the pages attached to that task.
- In the support inbox, the reply composer's **Article** tool inserts a help center article into a reply.
- The BlueHill mobile app has a **Wiki** tab with the same knowledge bases, pages, search, comments and editor.

## Guides

1. [The Wiki at a glance](./wiki-wiki-page-overview). The Wiki page, its header, toolbar, pins and page list, and the sidebar with the page tree.
2. [Knowledge bases, folders and the page tree](./wiki-knowledge-bases-and-folders). Switch and manage knowledge bases, create folders, the folder page, the tree menus and drag and drop.
3. [Find a page: search, pins and tags](./wiki-find-pages). Search from the sidebar, the search page, the command palette, filters and sort, pins, and tags.
4. [Create a page](./wiki-create-a-page). Blank pages, templates, subpages, the page header fields and the first save.
5. [Write and format a page](./wiki-write-and-format). The toolbar, the slash menu, tables, images, videos, code, links, page links, pasting and the markdown source view.
6. [Share a page and manage access](./wiki-share-and-permissions). Visibility, people and teams, permission levels, owners and what view-only readers see.
7. [Publish, pin, archive, move and delete a page](./wiki-manage-a-page). Reading a page, the status menu, the page menu, pins, moving and the trash.
8. [Comments, mentions and change requests](./wiki-comments-and-change-requests). Comment on a passage, mention teammates, reply, resolve, request a change and who is notified.
9. [Version history and restore](./wiki-version-history). Every saved version, what changed, named versions and restoring.
10. [Link pages to boards, tasks and tickets](./wiki-link-pages-to-work). Attach pages to tasks and boards, insert articles into support replies, backlinks and broken links.
11. [Import and export](./wiki-import-and-export). Bring in a Slab export, a Freshdesk knowledge base or markdown files, roll an import back, and export everything.
12. [FAQ and troubleshooting](./wiki-faq-and-troubleshooting). Quick answers to the questions we hear most.

## How these guides are written

- **Bold text** is a label you will see on screen, such as a button, a tab or a field.
- A path with arrows, such as **Navigation → Wiki**, means open the first item, then the next.
- *Italic text* is a value you might pick or type, such as a tag name.
- Screenshots were taken in a demo workspace called Acme Inc. Your knowledge bases, pages and team members will differ.