Storage quota

Every company has a storage quota — the maximum total size of everything stored in Documents (including files created by other apps).

Purpose

It helps you monitor the space in use, understand what happens when the quota is full, and know how to free space.

When to use

Check it regularly, when you see a warning banner, or when an upload is rejected.

Before you start

  • Viewing the storage report at /documents/reports/storage needs documents:write.
  • Moving files to the trash and restoring them needs documents:delete and documents:restore; version-retention settings need documents:manage.

See current usage

Current usage and the quota limit appear at /documents/overview and /documents/settings, with a breakdown by top-level folder (Apps/Finance, Apps/HR, your manual folders, and so on) so you can see exactly what is using space.

Understand near-full behavior

When usage approaches the quota, uploads still work but a warning banner appears; once the quota is reached, new uploads and new versions are rejected until you free space or raise the quota.

Free up space

Free space by permanently deleting files in the Trash (soft-deleted files still count toward the quota until they are purged) or by deleting old versions of large files through Settings → Version Retention.

Raise the quota

The quota size is a subscription plan setting; contact your account administrator or XBuddy support to raise it.

The quota is reserved atomically at upload time, and an upload over the quota is rejected rather than truncated. Restoring a file from the trash must reserve space again, so it can fail if the company is now at its quota.

All versions are kept indefinitely by default. You can turn on automatic deletion of versions older than N days in /documents/settings → Version Retention.