Halloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix NowHalloween DealsAmazon USOctober picks are moving - compare before checkoutAmazon US: current deals, useful picks and tech finds.See Picks×
FREEDOM251

Freedom251 › Blog › Documentation

What Belongs in a Plane Page, and What Belongs in a Work Item?

By Freedom251 Team · · 3 min read

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Use a Page for information people need to read, discuss, or refer back to; use a Work Item for a discrete outcome someone needs to own and move through a workflow. When a project needs both context and action, keep the explanation in a Page and track each actionable deliverable as a Work Item linked to it.

Page or Work Item: the quick decision

Ask whether the content is mainly information to understand or work to complete and track. Plane describes Pages as collaborative documents and a Work Item as a single piece of work a team tracks. The distinction is about purpose, not about how much text you have: a long task description can still belong in a Work Item, while a short decision record can be a Page.

As an Amazon Associate I earn from qualifying purchases.

Question Choose a Page when… Choose a Work Item when…
What is the main purpose? People need explanatory or reference content, such as a specification, meeting notes, runbook, decision record, onboarding guide, or design rationale. Plane Pages documentation The team needs to track a specific outcome, such as a task, bug, feature request, or support ticket. Plane Work Items documentation
What should happen to it? People should read, maintain, discuss, or consult it over time. Someone should own it and move it through the team’s workflow to completion.
How does it relate to other work? It can provide context for several deliverables and include embedded work items. Plane Pages documentation It can link to the Page that contains its specification, rationale, or decisions. Plane Work Items documentation

What belongs in a Page

Put material in a Page when its value is the explanation itself, rather than a status to advance through a workflow. Examples include a product specification, meeting notes, a runbook, a decision record, an onboarding guide, or project documentation. Pages support collaborative editing, comments, and embedded live Work Items, so the document can hold the narrative while linked or embedded records represent the work that follows from it. Plane Pages documentation

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Choose the Page location by audience

  • Project Pages: specifications, plans, notes, and documentation tied to a particular project.
  • Workspace Wiki: policies, architecture decisions, and knowledge shared across projects or teams.
  • Teamspace Pages: a team’s processes and guidelines. Plane Pages documentation Plane workspaces documentation

Plane’s documentation says Pages can be moved between locations. The available features vary by location; if access controls, sharing with specific members, collections, or link-page blocks matter to your use case, check Plane’s current Pages feature matrix before deciding where to keep the document.

What belongs in a Work Item

Use a Work Item for a piece of work with an outcome the team wants to track: for example, a task, bug, feature request, or support ticket. Plane defines it as “a single piece of work your team tracks in Plane.” Each Work Item belongs to one project. Its title is required; its description is optional rich text for implementation details and supporting information. Work Items can be grouped and scheduled using project planning features. Plane Work Items documentation

Make the action trackable, not every sentence

A requirement or note does not automatically need its own Work Item. Make it one when it represents work that needs ownership, tracking, or completion. Keep background, rationale, and enduring explanation in the Page; create separate Work Items for the independently actionable deliverables. This is a practical way to apply Plane’s object definitions, not a rigid product rule.

When you need both, connect them

A specification may explain the goal and constraints while several Work Items track the implementation, testing, or rollout. Keep the rationale and broader narrative in the Page, then link each deliverable to that context. Plane supports Work Item references in Pages and linked Pages on Work Items, so readers can move between the explanation and execution. Plane Pages documentation Plane Work Items documentation

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • Page: the agreed behavior, design rationale, and decisions for a feature.
  • Work Item: implement the feature, with an owner and a completion outcome.
  • Work Item: verify the feature against the specification.

If a Page contains a list of possible improvements, do not convert every bullet into a task by default. Create Work Items for the items the team has decided to pursue and needs to track; leave reference notes and unresolved context in the Page.

Rank #3
Sale
A Guide to the Project Management Body of Knowledge (PMBOK® Guide) – Seventh Edition and The Standard for Project Management (ENGLISH)
  • book
  • A Guide to the Project Management Body of Knowledge (PMBOK Guide) – Seventh Edition and The Standard for Project Management (ENGLISH)
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Keep the two objects complementary

Plane’s Pages and Work Items are designed for different jobs: Pages preserve and organize knowledge, while Work Items make discrete work trackable. Treating one as a substitute for the other can make the information harder to use: a document alone does not give each deliverable its own tracked record, and a set of tasks alone may lose the reasoning and shared context behind the work.

Rank #4
Sale
Harvard Business Review Project Management Handbook: How to Launch, Lead, and Sponsor Successful Projects (HBR Handbooks)
  • Harvard Business Review Project Management Handbook: How to Launch, Lead, and Sponsor Successful Projects
  • Harvard Business Review Press
  • BLANK BOOK

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

DocumentationPlaneproject managementwork items

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Recommended PC Tool
Recommended PC Tool
Outdated Drivers Are Slowing You DownFree scan - exact matches
PC Slower Than It Used to Be?Free scan - under a minute

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.