ARK

Tags & Organization

Tags are free-form labels that cut across spaces and nesting. Every page can have multiple tags, and tags make the scattered feel like a discoverable library.

Adding tags to a page

At the top of any page, click + Tag (or press T). Type a tag name — existing tags autocomplete; new ones are created on the fly.

Tag names are case-insensitive and trimmed. Design, design, and design all refer to the same tag.

Viewing tagged pages

Three ways to find pages by tag:

  • Click a tag on a page — opens a filtered list view of every page with that tag across all spaces you can read.
  • Tag directory — Cmd+K → Browse tags lists every tag in the workspace with page counts.
  • Search filter — in the search bar, tag:retro shows only pages tagged retro.

Cross-space vs space-scoped tags

By default, tags are workspace-wide — a tag in the Design space and a tag in the Engineering space are the same thing if they share a name.

Settings → Tags → Scope lets admins switch to per-space tags if you want stricter separation.

Tag colors

Under Settings → Tags, admins can assign colors per tag. Colored tags are more scannable — useful for categories like:

  • urgent — red
  • draft — gray
  • published — green
  • archived — blue

Users who want the tag list non-colored can toggle it off in Account → Display.

Tag groups

Group related tags for discoverability. E.g., the group Document type contains rfc, runbook, post-mortem. The tag directory displays groups as sections.

Configured in Settings → Tags → Groups.

Bulk operations

From the tag directory:

  • Rename a tag (propagates to every page).
  • Merge two tags.
  • Delete a tag (removes from every page; doesn't delete pages).

Tag views on space index pages

A space's index page can render tag-grouped sections automatically. Edit the index, insert /tag-list, pick the tags to show. Each section lists pages under that tag, updated on refresh.

Reserved tags

Some tags have built-in behavior:

  • draft — pages tagged draft are excluded from public publishing by default.
  • archive — pages tagged archive are hidden from search and sidebar (shortcut for archiving).
  • template — pages tagged template show up in the templates picker.

Workspace admins can add more reserved tags under Settings → Tags → Reserved.

Tag filters and search

Combine tags in search with AND (default) and OR:

  • tag:rfc tag:approved — pages tagged both.
  • tag:rfc OR tag:spec — pages tagged either.
  • tag:rfc -tag:draft — pages tagged rfc but not draft.

Automation

Tags can trigger automations (if the automation feature is enabled in your deployment):

  • Auto-apply a tag when a page is created in a specific space
  • Auto-remove a tag after N days
  • Notify a user when a tag is applied

Data model

Tags live in tags. Page-to-tag relationships in page_tags. See Database Reference.