Skip to main content

Plans and limits

OpenDocs keeps the CLI and the public API available on every plan. Plans differ in scale (how many workspaces, members, and published documents you can have) and in sharing flexibility (which visibility modes are available).

Current plans​

FreeProTeam
Workspaces12 included, then $4/month per extra workspaceUnlimited
Members per workspace35Unlimited
Published documents per workspace10UnlimitedUnlimited
API keys and CLIYesYesYes
Version historyYesYesYes
Workspace visibilityYesYesYes
Public publishingYesYesYes
PDF exportWith OpenDocs footerNo footerNo footer
Word (.docx) exportNoYesYes
Custom export brandingNoYesYes
Restricted-email visibilityNoNoYes
Custom profile + brandingNoYesYes
Role-based permissionsNoNoYes
SupportCommunityEmailPriority
  • Free, Pro, and Team are account-scoped. When you upgrade, the entitlement follows your user account instead of only one workspace.
  • Pro includes two owned workspaces. If you need a third or later Pro workspace, add extra Pro workspaces at $4/month each.
  • Team includes unlimited owned workspaces. Billing is per unique team member across the workspaces you own: the same teammate can be in several of your workspaces and only counts once.

The 10-document cap on Free​

A published document is one where isPublished = true. Drafts and soft-unpublished posts do not count. The cap is per-workspace, not per-user.

Enforcement happens at publish time in two places:

  1. Single publish (POST /api/v1/publish) — rejects the 11th publish with a 403 document_limit response.
  2. Batch publish (POST /api/v1/publish/batch) — runs an atomic pre-check before any document is written. If the batch would push the workspace over its cap, the whole batch is rejected up front with 403 document_limit.

The 403 body looks like:

{
  "error": "document_limit",
  "plan": "free",
  "limit": 10,
  "used": 10,
  "message": "Your free plan allows 10 published documents. You currently have 10."
}

The batch variant also includes requested (how many new docs the batch tried to add) and workspaceId so the CLI can print a precise message.

What doesn't count​

  • Unpublished posts. Calling POST /api/v1/posts/:id/unpublish (or the CLI's opendocs unpublish) frees a slot — your 11th publish succeeds as soon as another post is unpublished.
  • Updates. POST /api/v1/posts/:id/update edits an existing post in place. The count doesn't change, even on Free.
  • Drafts. If you've drafted markdown locally but never ran publish, it doesn't touch the quota.

How to see where you stand​

GET /api/v1/me returns the live quota for your current workspace:

{
  "quota": {
    "documents": {
      "plan": "free",
      "limit": 10,
      "used": 3,
      "remaining": 7
    }
  }
}

For Pro and Team workspaces, limit and remaining are null (JSON can't represent Infinity) — that's the signal for "unlimited."

Workspace and member caps​

Workspace creation is checked against the account that owns the new workspace:

  • Free owners can create 1 workspace.
  • Pro owners can create 2 workspaces, plus any paid extra Pro workspace add-ons.
  • Team owners can create unlimited workspaces.

Member caps are enforced per workspace for Free and Pro. Team is uncapped in the app because Paddle seats are the billing source of truth. When a new invite is accepted on a Team account, OpenDocs counts unique active members across every workspace owned by the subscriber and increases the Paddle seat quantity before activating the new membership.

If you hit the Free document limit​

Your existing documents stay published and readable. You simply can't publish new documents until you either:

  • unpublish some existing docs (frees slots immediately), or
  • upgrade to Pro.

Updates to documents you've already published keep working either way.

If your account has more owned workspaces than Free allows, existing workspaces stay intact. You simply cannot create more until your plan or workspace add-ons cover the count again.

If you cancel Pro​

Your account reverts to Free at the end of the billing period. Existing published docs stay live. The main impact is on what you can publish next (you're back to the 10-document cap) and which paid export/branding features remain available.

  • Solo experimentation with an agent — Free is enough.
  • Public docs, external sharing, DOCX export, or unlimited docs — Pro.
  • Several small workspaces for one person — Pro plus extra workspaces.
  • Unlimited workspaces and a shared team — Team.