PurviewHow-to

eDiscovery in the new Purview portal: cases, holds, searches and review sets step by step

Run a matter end to end in the unified eDiscovery experience: permissions, cases, data sources, holds, searches and statistics, review sets, exports and what changed from classic.

eDiscovery in Microsoft Purview is now a single experience: no separate Content search, eDiscovery (Standard) or eDiscovery (Premium) tool, just cases, with your licenses deciding which features you get. In this post I'll walk through a matter in the order it really runs and point out what behaves differently if you learned the classic tools.

How this guide is organized: Prerequisites → What changed from classic eDiscovery → Step-by-step → Verify → Tips & gotchasFlow diagram of the article's sections in reading order: 1. Prerequisites. 2. What changed from classic eDiscovery. 3. Step-by-step (8 steps: Review the global settings once; Create the case; Add data sources; Place holds; Search and generate statistics; Review in a review set; and 2 more). 4. Verify. 5. Tips & gotchas. Toolbox: Cases › Create case, Actions › Close case, DistributionResults, UniH, InPlaceHolds.1Prerequisites2What changedfrom classic e…3Step-by-step4Verify5Tips & gotchas1Review theglobal setti…2Create thecase3Add datasources4Place holds5Search andgenerate s…6Review in areview set+2 moreTOOLBOXCases › Create caseActions › Close caseDistributionResultsUniHInPlaceHoldsHow this guide is organized: Prerequisites → What changed from classic eDiscovery → Step-by-step → Verify → Tips & gotchasFlow diagram of the article's sections in reading order: 1. Prerequisites. 2. What changed from classic eDiscovery. 3. Step-by-step (8 steps: Review the global settings once; Create the case; Add data sources; Place holds; Search and generate statistics; Review in a review set; and 2 more). 4. Verify. 5. Tips & gotchas. Toolbox: Cases › Create case, Actions › Close case, DistributionResults, UniH, InPlaceHolds.1Prerequisites2What changed from classic eDiscovery3Step-by-step1Review the global settings once2Create the case3Add data sources4Place holds5Search and generate statistics6Review in a review set+2 more4Verify5Tips & gotchasTOOLBOXCases › Create caseActions › Close caseDistributionResultsUniHInPlaceHolds
At a glance: how this guide is organized · 8 steps · 5 key settings and tools

Status (October 2026): Microsoft Learn describes the old compliance portal as retired. eDiscovery runs in the Microsoft Purview portal (purview.microsoft.com), and Content search now lives inside eDiscovery as a system-generated Content Search case. Several review features are still marked preview, so re-check Microsoft's eDiscovery overview before you rely on them.

Prerequisites#

  • Licenses. Microsoft states that both the admins and the users who work in cases need a Microsoft 365 Enterprise E3 or E5 license, and that an admin without a SharePoint E3 license may find some SharePoint capabilities limited. Premium features, such as review sets and analytics, need Office 365 E5, Microsoft 365 E5 or a related E5 add-on.
  • Permissions. Add investigators to the eDiscovery Manager role group under Settings › Roles and scopes › Role groups. eDiscovery Managers work only in cases they're members of; people in the eDiscovery Administrator subgroup can see every case in the organization. Members of Organization Management can also create cases. Use a custom role group when some people should search but never export. If the portal says you don't have access, see Purview roles and role groups.
  • Audit and PowerShell. eDiscovery activity is written to the audit log, and the checks below use Security & Compliance PowerShell (Connect-IPPSSession help).

What changed from classic eDiscovery#

Classic toolsUnified eDiscovery
Content search was a separate toolA system-generated Content Search case, open to all eDiscovery Managers and Administrators; restrict it through that case's members
Custodians and noncustodial sources drove the workflowThe case is the organizing unit; you add people, groups and sites as data sources
Collections, immutable once added to a review setSearch statistics; searches stay editable even after results go to a review set
You reindexed partially indexed content yourselfAdvanced indexing runs automatically for statistics, review set additions and exports
JobsProcesses, tracked in the Process report
Different Standard and Premium export formatsOne export structure for both

Every case created in the Purview portal shows the Premium case type whatever your license; the type only maps cases back to the old portal. Some older cases carry a Limited format tag, and advanced indexing isn't available in them.

Step-by-step#

How an eDiscovery matter runs in the unified Purview experienceStep 1: Review settings, then create the case. Global settings once; a unique case name; add members in Case settings Step 2: Add data sources. A person brings their mailbox and OneDrive; add sites and groups for shared content Step 3: Place holds. An empty query preserves everything; wait until distribution has finished Step 4: Search and generate statistics. KeyQL plus conditions; generate a sample, then refine and rerun freely Step 5: Review in a review set. Items are copied and decrypted; filter, tag and run analytics Step 6: Export. From a search or a review set; search exports expire after 14 days Step 7: Close the case deliberately. Closing turns off all of its holds and releases the content1Review settings,then create thecaseGlobal settings once; aunique case name; addmembers in Casesettings2Add data sourcesA person brings theirmailbox and OneDrive;add sites and groups forshared content3Place holdsAn empty querypreserves everything;wait until distributionhas finished4Search andgenerate statisticsKeyQL plus conditions;generate a sample, thenrefine and rerun freely5Review in a reviewsetItems are copied anddecrypted; filter, tagand run analytics6ExportFrom a search or areview set; searchexports expire after 14days7Close the casedeliberatelyClosing turns off all ofits holds and releasesthe contentHow an eDiscovery matter runs in the unified Purview experienceStep 1: Review settings, then create the case. Global settings once; a unique case name; add members in Case settings Step 2: Add data sources. A person brings their mailbox and OneDrive; add sites and groups for shared content Step 3: Place holds. An empty query preserves everything; wait until distribution has finished Step 4: Search and generate statistics. KeyQL plus conditions; generate a sample, then refine and rerun freely Step 5: Review in a review set. Items are copied and decrypted; filter, tag and run analytics Step 6: Export. From a search or a review set; search exports expire after 14 days Step 7: Close the case deliberately. Closing turns off all of its holds and releases the content1Review settings, then create the caseGlobal settings once; a unique case name; add membersin Case settings2Add data sourcesA person brings their mailbox and OneDrive; add sitesand groups for shared content3Place holdsAn empty query preserves everything; wait untildistribution has finished4Search and generate statisticsKeyQL plus conditions; generate a sample, then refineand rerun freely5Review in a review setItems are copied and decrypted; filter, tag and runanalytics6ExportFrom a search or a review set; search exports expireafter 14 days7Close the case deliberatelyClosing turns off all of its holds and releases thecontent
Figure 1 · Process How an eDiscovery matter runs in the unified Purview experience. Run a matter in this order. Holds come before searching, and closing the case releases every hold, so confirm with legal first.

1. Review the global settings once#

The global eDiscovery settings control premium features for new cases, attorney-client privilege detection, guest access and tag templates. Read Microsoft's eDiscovery billing page too: depending on the data in your cases, storage charges can apply.

2. Create the case#

In the Microsoft Purview portal, open the eDiscovery solution and select Cases › Create case. Enter a case name (it must be unique in the organization) and an optional description, then select Create. You're added as a member automatically and land on the Searches tab. Open Case settings to add the other members and role groups and to set the data source, search and analytics, and review set options. Use the Number field for your matter or docket number.

3. Add data sources#

Data sources are the locations the case reuses in every search and hold. Add a person and the case includes their associated resources, such as their mailbox and OneDrive; data source mapping can also add a group's site and show frequent collaborators. Add SharePoint sites and Microsoft 365 groups for shared content. For a one-off location, add it to a single search or hold instead of the whole case.

4. Place holds#

On the Hold policies tab, create a hold policy and add the data sources. Leave the query empty to preserve everything in those locations, or add one to create a query-based hold that preserves only matching content. Don't report the data as preserved until distribution has finished (see Verify). Searches can then simply target the locations on hold.

5. Search and generate statistics#

Create a search on the Searches tab, add data sources, and build the query from keywords (KeyQL) plus conditions such as dates, participants or file types. Run it for statistics: estimated item count and size, the locations with the most hits and the items each query returns. Then generate a sample to look at real items before you commit. Refine and rerun freely; each statistics run also reindexes partially indexed items.

6. Review in a review set#

Add the search results to a review set. The items are copied to a secure, Microsoft-provided Azure Storage location, and content protected by Microsoft Purview Message Encryption, sensitivity labels or Azure Rights Management is decrypted automatically. You can include the target files of cloud attachments, all versions of SharePoint documents and whole Teams or Viva Engage conversation threads. Inside the review set, filter and save queries, tag items (for example "nonresponsive"), and run analytics such as near-duplicate detection, email threading and themes; OCR makes text in images searchable.

7. Export#

Export straight from a search (mailbox items as PST files or individual messages, SharePoint and OneDrive documents as native copies) or from a review set (selected documents, all filtered documents or all documents). Search export packages expire 14 days after creation, so download them promptly. If an export fails or doesn't match the statistics, use eDiscovery search and export errors and the eDiscovery error quick reference.

8. Close the case deliberately#

Closing or deleting a case turns off all of its holds, and content that was on hold is released. Confirm with legal first, then use Actions › Close case. A case with holds shows Closing while they're removed; Closed with errors or Pending delete usually means a hold policy didn't update, so fix it and redistribute the policy.

Verify#

Check hold distribution in Security & Compliance PowerShell, then confirm the hold on a mailbox:

PowerShell
Connect-IPPSSession
Get-CaseHoldPolicy -Case "Contoso-HR-0142" -DistributionDetail |
    Format-List Name, Enabled, DistributionStatus, DistributionResults

# Exchange Online PowerShell: eDiscovery case holds appear as UniH<GUID>
Connect-ExchangeOnline
Get-Mailbox -Identity adele@contoso.com | Format-List InPlaceHolds

Good looks like DistributionStatus : Success with no failed locations in DistributionResults, and a UniH entry in InPlaceHolds for each held mailbox. Then compare the search statistics with the export's summary report, and search the audit log for the case's eDiscovery activities to confirm they were recorded.

Tips & gotchas#

  • Lock down the Content Search case. Every eDiscovery Manager and Administrator can see it by default; trim its members if searches there are sensitive.
  • Holds aren't retention. A case hold lasts as long as the case. For long-term keeping, use retention policies; see retention policies, labels and litigation hold. Held SharePoint and OneDrive content can grow the Preservation Hold library.
  • Insider risk escalation. Insider Risk Management cases can be escalated into eDiscovery for legal review; see Insider Risk Management setup.
  • Search and delete. eDiscovery can also delete harmful email, Teams chat messages and Copilot and AI app data. Check the query's statistics first; deletion can't be reviewed afterwards.
  • Automation. The Microsoft Graph eDiscovery API (/security/cases/ediscoveryCases) supports delegated and app-only authentication for scripted case work.

References#

Revision history: Oct 2026 — revised and re-checked against current documentation.

Written and checked against current Microsoft Learn documentation. Test changes with a pilot group before rolling them out to everyone, and if an admin center path has moved since, search for the setting name instead.

Spotted a mistake, or did this fix work differently for you? Email me or message me on LinkedIn — corrections are credited in the article.

Written by

Omer Eltayeb

M365 Subject Matter Expert, former Microsoft Cloud Solutions Architect, Microsoft Certified Trainer and Microsoft Innovative Educator Expert (2024–26) and Microsoft Elevate Educator Expert (2026–27). I share practical, step-by-step guides, study plans, scripts and toolkits for Microsoft Intune, Configuration Manager, Microsoft Entra ID, Microsoft Defender, Exchange and Microsoft 365 with the community.

Microsoft Certified Trainer (MCT) 2026Microsoft Innovative Educator Expert 2025–2026Microsoft Elevate Educator Expert 2026–2027ISC2 Certified Information Systems Security Professional (CISSP)Microsoft 365 Certified: Enterprise Administrator Expert (MS-102)