Usage, plan limits, and billing
The Usage page shows how much of your plan you have used this period. The Billing page shows your plan, lets you upgrade, and opens the subscription portal. Billing is hosted-only. Self-hosted installs hide Billing and have no plan limits.
How do I check my usage in Socifyr?
Open Usage in the sidebar. A badge shows your plan, and four cards show a bar against the limit:
| Card | What it counts |
|---|---|
| Posts this month | Published posts. A post sent to several accounts counts once. |
| X posts this month | Posts to X, which bills per post. The hint shows approximate spend this month. |
| Connected accounts | Accounts connected in the workspace |
| Storage | Media library bytes |
A bar turns amber at 80 percent and red when you reach the limit, with "Limit reached - upgrade to raise it." Plans with no cap show an Unlimited badge. Below the cards, anyone not on Business sees an Upgrade link.
The same numbers are available from code: socifyr usage, the MCP get_usage tool, and GET /api/usage.
What are the limits on each plan?
These values come from TIER_LIMITS in the shared package, which the API enforces.
| Limit | Free | Pro | Business |
|---|---|---|---|
| Uploads per month | 30 | Unlimited | Unlimited |
| Connected accounts | 3 | 10 | 40 |
| X posts per month | 5 | 50 | 300 |
| Media storage | 1 GB | 50 GB | 500 GB |
| Scheduling | No | Yes | Yes |
| Webhook endpoints | No | No | Yes (up to 25) |
| API keys | 1 | 5 | Unlimited |
| Team members (incl. owner) | 1 | 3 | Unlimited |
| Media library | Yes | Yes | Yes |
| History retention | 30 days | Full | Full |
Notes:
- Account limits only apply when adding a new account. Reconnecting never counts against you, and a workspace that is already over a lowered limit keeps what it has.
- Posts to X over your monthly allowance are blocked until the monthly reset.
- Current prices are shown on the Billing page. Monthly and yearly options exist for Pro and Business.
How do I upgrade my plan?
- Open Billing. You need
billing.viewto see it. Only the Owner hasbilling.manage. - Use the Monthly / Yearly toggle.
- Click Upgrade to Pro or Upgrade to Business. The button says "Redirecting..." while it opens the checkout page.
- Pay. You land back on Billing with a toast, "Subscription activated".
Your current plan is marked Current Plan. For lower tiers, the button reads "Contact support to downgrade".
How do I cancel or change my subscription?
On Billing, click Manage Subscription in the Current Plan card. It opens the billing portal. If you have never subscribed, you get "No billing account found. Please subscribe to a plan first."
What error do I get at a limit?
| Limit | API message |
|---|---|
| Monthly uploads | Upload limit reached for your plan. Upgrade to continue. |
| Storage | Storage limit reached for your plan. Delete unused media or upgrade to continue. |
| Scheduling on Free | Scheduling is not available on your current plan. Upgrade to continue. |
| Webhooks below Business | Webhooks are not available on your current plan. Upgrade to Business to continue. |
See Error handling for how to handle these in code.
Common problems
| Symptom | Fix |
|---|---|
| No Billing in the sidebar | Your role lacks billing.view (Owner and Admin have it), or the install is self-hosted. |
| Cannot click Manage Subscription | Only an Owner can manage billing. |
| Usage looks wrong after upgrade | Refresh the page. The plan badge updates when checkout completes. |
FAQ
Is the media library a paid feature?
No. The shared plan config enables it on every plan.
Where do webhooks get configured?
Not in the dashboard. Use the webhooks API on a Business plan.