| name | purview-records-management |
| description | Guidance for Microsoft Purview Records Management — declaring, managing, and disposing records across SharePoint, OneDrive, Exchange, and Teams. Covers retention labels with record / regulatory record options, file plan import, event-based retention (employee leaves, contract expires), disposition review (single- and multi-stage), proof of deletion / records of disposition, retention label policies vs auto-apply policies (KQL/sensitive info types/trainable classifiers), label-aware DLP, integration with Information Governance vs Records Management licensing, and role separation between records managers and admins. WHEN: records management Purview, file plan, retention label record, regulatory record, event-based retention, disposition review, record declaration SharePoint, immutable records, audit-proof deletion, file plan import. DO NOT USE for non-records data lifecycle (use purview-data-lifecycle), DLP policies (use purview-dlp-policy), or eDiscovery (use purview-ediscovery). |
| license | MIT |
| metadata | {"author":"Microsoft","version":"0.1.0"} |
Microsoft Purview Records Management
Records Management is the formal, auditable side of data lifecycle in Microsoft 365.
Where general retention manages bulk data lifecycle, Records Management declares
specific content as a record (cannot be modified or deleted) or regulatory record
(immutable, no label change allowed once applied) and produces proof of disposition —
the artefact regulators and auditors actually ask for.
When to use
You have legal, regulatory, or industry obligations (SEC 17a-4, GxP, GDPR Article 30,
public-sector records acts) that require provable record retention and defensible
disposition workflows.
Do not use this skill for general retention without record declaration
(purview-data-lifecycle), DLP (purview-dlp-policy), or eDiscovery
(purview-ediscovery).
Retention label flavors — pick deliberately
| Label option | Mutability | Disposition |
|---|
| Retention only (no record) | Editable | Auto-delete or do nothing |
| Record | Locked from edits/deletes; admin can unlock | Disposition review optional |
| Regulatory record | Fully immutable; label cannot be removed even by admin | Always disposition-reviewed |
| Unlock the record (admin action) | Reverts to standard label | — |
Rule of thumb: Use regulatory record only where the regulation truly demands
WORM-style immutability (broker-dealer, life sciences GxP). Otherwise record is
usually right — same protection, with an admin-unlock break-glass.
Approach
-
Get the file plan first. Records Management without a file plan is just labels
sprawled across SharePoint. Source the file plan from Legal/Records team — typically
a CSV with: label name, description, retention period, trigger (creation date / last
modified / event), record/regulatory record flag, disposition action, business unit.
Import via file plan manager.
-
Define events for event-based retention. Common events:
- Employee separation (HRIS connector or scripted Graph trigger).
- Contract expiry (CLM system event).
- Project closure.
- Product end-of-life.
Events fire via Microsoft Graph or the compliance UI; retention countdown begins on
event date.
-
Publish vs auto-apply retention label policies.
- Publish = label appears in user pickers; users tag content. Use for SharePoint
document libraries with known content classes.
- Auto-apply = system applies based on KQL, sensitive info types, or trainable
classifiers. Use for high-volume / known-pattern content (invoices, contracts).
-
Pilot in a single SharePoint site / mailbox set. Validate that:
- Labeled documents lock as expected.
- Edit attempts are blocked.
- Co-author scenarios (Teams files) still work.
- Retention countdown matches plan.
-
Disposition review. For records nearing end-of-retention, the Disposition
queue presents items to reviewers (single or multi-stage). Reviewers can: dispose
(delete with audit), relabel (extend retention), or hold (pending litigation). Records
of disposition are retained — that's the audit artefact.
-
Role separation.
- Records Management role group: file plan, labels, disposition decisions.
- Compliance Administrator: configures the service, not the records.
- Reviewer (Disposition): per-label disposition reviewers.
Records managers should not be tenant Global Admins.
-
Reporting + audit. Pull disposition reports monthly. Stream to Sentinel or a
compliance system of record. Maintain the chain of custody artefact.
-
Integrate with eDiscovery and Information Barriers. Records can still be subject
to legal hold; Information Barriers don't override retention. Confirm precedence
rules with Legal.
Guardrails
- Records Management is a separately licensed add-on (Microsoft 365 E5 Compliance /
E5 Information Protection & Governance). Confirm licensing per-user — auto-apply on
unlicensed users silently fails.
- Regulatory record is irreversible. Once a doc is labeled regulatory record, no
one — including a tenant Global Admin — can change or remove the label. Pilot with
test content only.
- Event-based retention needs a reliable event source. Don't fire termination
events from a flaky integration; you'll over-retain or under-retain forever.
- Don't auto-apply records broadly with weak KQL. Mass-labeling production sites as
records bricks the user experience (no edits).
- Co-authoring + record label combinations have caveats. Test in Teams/SharePoint
before mass rollout.
- Disposition queues need owners. Without active reviewers, items sit at end-of-
retention indefinitely, defeating the disposition story.
- Retention wins over deletion. A user "deleting" a record just hides it from view;
it's preserved in the preservation hold library. Set expectations.
- Don't conflate retention and backup. Retention preserves the live data in M365;
it's not a tenant restore plan.
Common anti-patterns
- "Imported file plan with 800 labels" — users see a giant picker, label nothing
correctly. Start with the 10-20 most important records.
- "Used regulatory record by default 'to be safe'" — operational nightmare on first
mistake.
- "Auto-apply records via 'contains the word contract'" — labels every email
signature mentioning contracts as a record. Use sensitive info types or trainable
classifiers.
- "Disposition queue ignored for 12 months" — retention extended by default; audit
finding.
- "Records Management admin = Global Admin" — segregation-of-duties violation in
regulated industries.
- "Skipped event-based retention because 'all records use creation date'" — over-
retention on long-tail content; cost and risk.
- "Records Management used for backup" — wrong tool; restore scenarios still need
proper backup.
Example prompts
Roll out Purview Records Management for SEC 17a-4 compliance with 6-year regulatory record retention on broker communications.
Import a 60-label file plan from the records team and pilot on 3 SharePoint sites.
Configure event-based retention: employee separation from Workday triggers a 7-year HR records hold.
Design the disposition review workflow with 2-stage approvals: business owner then records manager.
Compare retention label, record, and regulatory record for our contract management scenario.
Integrate Records Management with our existing eDiscovery Premium holds for active litigation matters.
Build the audit-of-disposition export to feed our GRC system monthly.
Microsoft Learn