How documents work
Every document in Plane belongs to a subject: either a specific worker or your workspace as a whole. This distinction lets you keep worker-specific files (like a signed agreement or W-9) attached to the right person, while company-wide documents (like an employee handbook or policy document) live at the workspace level. Documents can be:- Uploaded files—PDFs, images, and other files you upload directly
- Authored content—Documents created and edited inside Plane
- Auto-generated artifacts—Documents created by other workflows, like a signed agreement that gets stored as a document after signing
Uploading documents
You can upload documents from several places in Plane: the main documents section, a worker’s profile, or as part of a compliance workflow.Navigate to documents
Go to the documents section from the main navigation, or open a specific worker’s profile and find their documents tab.
Upload your file
Click upload and select the file from your computer. Plane accepts common file formats including PDF, images, and office documents.
Name and organize
Give the document a clear name. Plane will suggest a name based on the file, but you can change it to something more descriptive.
Labels and categories
Documents can be organized with labels, which help you filter and find documents quickly. Plane applies some labels automatically—for example, documents created by tax form or agreement workflows are labeled with their type. Labels are useful for:- Filtering the document list to find a specific category (like all tax documents or all agreements)
- Understanding context at a glance—a document’s labels tell you what it is for without having to open it
- Organizing large document libraries across many workers
Worker-specific vs. workspace-level documents
Documents in Plane are scoped to either a worker or the workspace: Worker documents are attached to a specific person. These include their tax forms, signed agreements, identity documents, and anything else specific to that worker. You can view all of a worker’s documents from their profile. Workspace documents belong to the company, not a specific worker. These might include company policies, templates, or reference documents that apply to everyone. When browsing documents, you can filter between these scopes to find what you need.Public vs. private documents
Every document has a visibility setting that controls who can see it:- Shared (public) documents are visible to both admins and the worker they belong to. Use this for documents the worker needs access to, like their signed agreement or a company policy.
- Private documents are visible only to admins. Use this for internal documents that workers should not see, like internal notes or sensitive records.
Downloading and sharing documents
You can download any file-type document directly from Plane. From the document detail view, use the download option to save a copy to your computer. For authored content (documents created inside Plane), you can view the content directly in the browser. Documents that are shared with a worker are accessible from the worker’s own Plane account, so they can download their own documents without needing to ask you for a copy.Documents created by other workflows
Many documents in Plane are created automatically by other parts of the system:- Signed agreements—When an agreement is fully signed, a document artifact is created and stored automatically
- Tax forms—Completed tax forms (W-9, W-8BEN, I-9, etc.) are stored as documents attached to the worker
- Compliance documents—Documents collected during onboarding or compliance workflows are filed in the worker’s document library
API access
The Documents API gives you programmatic access to view documents associated with your workers and workspace.Can workers upload their own documents?
Can workers upload their own documents?
Workers can submit documents as part of compliance and onboarding workflows (like uploading identity documents or tax forms). The documents section in the admin dashboard is where admins manage and organize the full document library.
Is there a file size limit for uploads?
Is there a file size limit for uploads?
Plane supports standard document uploads. For very large files, contact support@plane.com if you run into any issues.
Can I search across all documents?
Can I search across all documents?
Yes. The documents section includes a search bar that searches by document name across all documents in your workspace. You can also filter by label to narrow results.