Storage Overview
Storage Overview is the system administrator view of platform file storage. It shows three summary KPI cards for total platform usage, then lists every tenant with their used storage, quota, file count, and usage percentage. Clicking a tenant row opens a drill-down page where the administrator can browse that tenant’s individual files and trigger a storage reconciliation. System administrators use this page for capacity planning, billing support, and identifying tenants that are approaching or exceeding their storage quota.
Accessing the Page
Section titled “Accessing the Page”- Route:
/storage - Menu Path: Settings → System → Storage Overview
- Primary audience: System administrators only. Accessed via the system admin login at
system.portal.net— not the tenant portal.
What you can do here
Section titled “What you can do here”- View the total storage used across all tenants, a count of tenants at or above 80 % of their quota, and the total file count platform-wide.
- Browse a per-tenant list sorted by usage percentage (highest first) showing each tenant’s name, used bytes, quota, file count, and a visual usage progress bar.
- Filter tenants using a minimum usage percentage threshold (e.g., show only tenants above 50 % full).
- Search tenants by name or subdomain.
- Click a tenant row to open the tenant storage detail page at
/storage/:tenantId, which lists individual files with their size, content type, source service, and upload date. - From the tenant detail page, trigger a Reconcile operation to recalculate that tenant’s storage usage totals from the actual file records.
Common tasks
Section titled “Common tasks”- Open Settings → System → Storage Overview at
system.portal.net. - Check the Tenants Near Quota KPI card — a non-zero value indicates tenants that need attention.
- The list is sorted by usage percentage by default. Tenants at the top are the highest consumers.
- Use the Minimum Usage % filter to isolate tenants above a threshold (e.g., 80 %) for a focused capacity review.
- Click a tenant row to open the drill-down and review individual file details.
- If the tenant’s displayed usage seems incorrect, click Reconcile on the detail page to recalculate totals from actual file records.
- Coordinate with the tenant owner before deleting any files from the detail page.
- Tenants with Unlimited quotas do not trigger the near-quota warning and are excluded from the Tenants Near Quota count.
- The list uses a Load More pagination pattern — scroll down and click the button to load additional tenants.
- Default sort is by
usagePercentdescending so the most storage-intensive tenants appear first. - The Reconcile action on the tenant detail page recalculates the stored
usedBytescounter by summing actual file sizes. Use it when the displayed usage diverges from the actual files shown in the list. - This page (
/storage) is for system administrators only. Tenant administrators manage their own storage at a separate tenant-scoped page. The route/storage-managementserves that tenant-level purpose.
Dashboard sections
Section titled “Dashboard sections”KPI Cards
Section titled “KPI Cards”Three summary cards appear at the top of the page, calculated from the current visible dataset.
| Card | What it shows |
|---|---|
| Total Platform Storage | Combined used storage across all tenants displayed in human-readable bytes (KB, MB, GB, TB) |
| Tenants Near Quota | Count of tenants at 80 % or more of their storage quota (excludes unlimited tenants); card turns red when count is above zero |
| Total Files | Total number of individual files across all tenants |
Tenant Storage Table
Section titled “Tenant Storage Table”A sortable list showing one row per tenant. Click any row to open the tenant storage detail page.
| Column | Sortable | Description |
|---|---|---|
| Tenant | Yes | Tenant display name and subdomain |
| Used | Yes | Storage consumed in human-readable bytes |
| Quota | — | Assigned storage quota, or “Unlimited” |
| Files | Yes | Total number of files in the tenant |
| Usage | Yes | Visual progress bar and percentage used; turns amber at 80 % and red at 100 % |
Tenant Storage Detail (drill-down)
Section titled “Tenant Storage Detail (drill-down)”Clicking a tenant row opens /storage/:tenantId — the per-tenant file browser.
The detail page shows:
- A usage widget with used bytes, quota, file count, and a progress bar for that tenant.
- A Reconcile button that recalculates the tenant’s usage totals from actual file records.
- A filterable file list with columns for file name, size, content type, source service, and upload date.
- Filters for source service and content type.
Related Pages
Section titled “Related Pages”- Billing Summary — billing dashboard that includes a storage summary card linking to this page
- Tenant Management — manage tenant quotas and subscription limits