DocumentationDecisionsCreating Decisions

Creating Decisions

Open the form

Route: /teams/:teamId/:spaceSlug/:pageSlug/_new/

  • Click Decision on the page list
  • Shortcut ⌘⇧C / Ctrl⇧C

Requires: Write Pages (or Owner).

Form fields

FieldRequiredNotes
IconNoEmoji picker for visual scan
TitleYesShort summary
DescriptionYesContext and details
ReasoningYesWhy this option—core audit trail
AssigneesNoTeam members responsible for implementation
DeadlineNoShown on cards and detail sidebar
TagsNoFilterable labels
AttachmentsNoFiles; subject to plan size limits

Save options

Save as Draft

  • Status: Draft
  • Visible to you and users with management powers
  • Fully editable
  • Use while iterating before team review

Publish Decision

  • Status: Proposed
  • Team can see and discuss
  • Sets finalized timestamp and author
  • Content becomes frozen for non-managers (see below)

Editing later

Route: …/:decisionId/_edit/

  • Draft: authors with Page Write can edit all fields and attachments.
  • Published (non-draft): banner explains content is frozen; only status changes allowed via Management panel for authorized users.
  • Shortcut ⌘⌥C / Ctrl⌥C when viewing a decision you can edit.

Attachments & encryption

Files upload to team storage. End-to-end encryption features apply per plan (see pricing). Uploads count toward team storage quota and max file size per plan.