Documents · Administration
Storage Analysis
Understand how your organization’s document storage is used, investigate missing or unlinked items, and permanently remove items you have reviewed and no longer need.
Open: Settings → Documents → Storage Analysis
Who can use Storage Analysis?
Storage Analysis is available to users with access to Document Settings who belong to the Org Admin or Global Admin group. Users outside these groups do not see the Storage Analysis tab.
To select items for cleanup and use Destroy selected, you also need Delete permission for Documents. Actions inside a document preview follow the applicable document permissions.
Run an analysis
- Open Settings → Documents and select Storage Analysis.
- Click Run Analysis in the title bar. Before your first scan, you can also use the button in the center of the page.
- Wait for the three steps to finish, then review the summary dashlets and findings grid.
Read file metadata from the organization’s configured Azure or local document storage. The discovered file count appears beneath this step.
Check document records, file locations, previews, templates, and direct or indirect associations with business records.
Compare stored files with database references and prepare the findings for review.
A spinning ring identifies the active step. Each step shows its timing, and the document-checking step shows its progress count. Completed steps display green checkmarks, and the stepper remains visible after the report is ready.
Use Cancel analysis to stop a scan. A canceled scan does not produce a complete report; click Run Analysis to start again.
The report reflects the time of the scan. Uploads, replacements, and record changes can affect the findings. Check the selected storage provider before interpreting missing-file results, particularly after a storage configuration change.
Understand the summary dashlets
Click a finding dashlet to filter the grid to that category. Click Storage to remove the finding-category filter and view all findings; other grid filters still apply.
| Dashlet | What it tells you | What to review |
|---|---|---|
| Storage | Total stored file size and file count. The active Azure or local provider is highlighted; the other provider is grayed out. | The provider and overall usage. Click this dashlet to view all finding categories. |
| Referenced files | Stored files with a database reference, including document originals, previews, templates, and retained deleted documents. | Open the associated document or file to understand its use. Referenced rows are not selectable for bulk destruction. |
| Orphaned files | Files exist in storage, but the analysis found no document, preview, or template reference to them. | Preview the file and confirm it is no longer required before selecting it for permanent removal. |
| Missing files / locations | A referenced filename was not found in the current storage, or a document record has no file location. | Review the record and determine whether the file should be restored or the eligible document record should be destroyed. |
| Unlinked documents | Active document records without an associated business record. Direct links, entity fees, and events with an owner are considered when checking associations. | The file may still exist and be previewable. An unlinked document is not automatically an orphaned or missing file. |
How counts and sizes are calculated
- Referenced and orphaned sizes come from actual files in storage. Shared references do not count the same physical file several times.
- Missing sizes show Size unavailable when files or locations are missing; the analysis cannot measure a file it cannot find.
- Unlinked sizes show the known stored size of their original files. Any documents without an available size are identified separately.
- Counts describe different things. Stored, referenced, and orphaned totals count files; unlinked totals count document records. Missing findings include unresolved filenames and absent document locations.
Review and navigate the findings
Use collapsed or expanded view
Use the Expand / Collapse control in the grid toolbar to switch between compact icons and readable details.
- Collapsed: the finding is shown as an icon with a tooltip. Associated records use their contact, entity, relationship, or other record-type icons.
- Expanded: finding labels and descriptions are visible, record references are readable, and longer text wraps within the cells.
- Pinned columns: checkboxes, when available, the finding, and the storage filename stay on the left while you scroll horizontally through the remaining information.
Open a document or file
Click a findings row to open the existing document preview. For an orphaned file, the file is previewed directly without creating a database record. For a missing file, the available document record can still be reviewed. If several documents reference the same file, choose the record you want to open.
Preview availability depends on the file type and whether the file is accessible. Use Download where available. Editing, saving, deleting, and destroying options depend on your permissions and the item’s eligibility.
Quick-preview an associated record
In collapsed view, click a supported contact, entity, or relationship icon. In expanded view, hover over the reference and use the detail button on the right. The standard record quick preview opens separately from the document preview.
Search, filter, and export
Use the grid toolbar to search, apply filters, choose visible columns, export findings to CSV, or reset the grid filters. Changing filters clears the cleanup selection. A storage filename may differ from the document’s display name; use Database references and Associated records to identify the item.
Permanently clean up selected items
Authorized users can select up to 100 files and document records per batch. A single finding can represent more than one document record, so the limit applies to the items affected, not just the number of checked rows. The toolbar displays the selection count.
| Selected finding | Permanent action |
|---|---|
| Orphaned file | Remove the physical file from storage. There is no corresponding document record to destroy. |
| Eligible missing file / location | Destroy the document record whose original file or location is missing, using the existing document destruction process. |
| Eligible unlinked document | Destroy the document record and remove its remaining original file and previews through the existing document destruction process. |
Document destruction can also remove related document dates, alerts, reminders, and tasks. It does not mean destroying the contact, entity, or relationship itself.
- Review the findings and open any files or records you need to investigate.
- Use the row checkboxes to select eligible items. The header checkbox selects eligible findings on the current page; the 100-item limit still applies.
- Click Destroy selected in the grid toolbar.
- Review the counts, item list, and permanent-action warning in the confirmation dialog.
- Select I have reviewed the selection and understand that destruction is permanent.
- Confirm with Destroy selected and keep the window open until cleanup finishes.
The system checks the findings again before cleanup. Changed files, restored files, newly linked records, or files shared with another document or template may be skipped. The result shows how many files and records were destroyed and lists items that could not be destroyed.
The analysis refreshes after the batch completes. Review the updated findings and any skipped-item messages before starting another batch. If cleanup is interrupted or reports an error, run a fresh analysis before retrying.
Common questions
Why are some Missing checkboxes disabled?
A missing preview is different from a missing original document. A document is not eligible for destruction solely because its preview is missing. Missing templates, findings without an eligible document record, and read-only records are also not selectable. Referenced rows are excluded from bulk destruction.
Why are there no checkboxes or Destroy selected action?
Your account needs both an eligible admin group and Delete permission for Documents. The action appears after you select an eligible item. If access was recently changed, refresh your session and check your permissions with your administrator.
Does Unlinked mean that the file is missing?
No. Unlinked describes the document record’s business association. Its file may still be present and referenced in the database. Open the document to review it before deciding what to do.
Why was a selected item skipped?
Its state may have changed since the scan, its file may be shared, or the record or storage operation may not have completed successfully. Read the item’s result message and review the refreshed report. A selection is not a guarantee that the item remains eligible for destruction.
Can a preview or scan fail even when a record exists?
Yes. A database record does not guarantee that its file is available in the configured storage. Check the provider, storage access, and file location. If the scan cannot complete, resolve storage access before using a new report for cleanup decisions.
Do preview edits automatically update the report?
Run Analysis again after saving or deleting a document in its preview. The report is a snapshot of the scan. The bulk cleanup process refreshes the analysis automatically after it finishes.