← TenantTools365Blogone .sppkg · seven tools
TrimVersions365 · Comparison

Intelligent versioning vs. a hard version limit in SharePoint: which to turn on, and what each one deletes

Microsoft now offers two ways to control version history — a fixed count, or automatic age-based thinning. They keep different versions, reclaim different amounts, and one of them is much safer to switch on blind.

Published 2026-08-06 · by HS Services

Until 2024 SharePoint had one knob: keep the newest N versions. Now there are two. They sound interchangeable and are not.

Hard limit: keep the newest N

Set per library (or per site/tenant as a default). SharePoint keeps the newest N major versions of each file and drops the oldest on every save. The UI floor is 100; PowerShell goes lower (how).

Automatic (intelligent) versioning

Set per tenant, site or library. SharePoint keeps every version from the last 30 days, then thins by age: one per day for a period, then one per week, then one per month, up to the library's overall limit.

What each one deletes from an existing library

Neither setting touches existing versions until the file is saved again, or until you run a trim job. That is where the comparison gets concrete. Suppose a 40 MB report has 480 versions over 14 months:

SettingVersions keptSpace kept
Hard limit 100newest 100 (probably the last few weeks)~4 GB
Hard limit 5newest 5~200 MB
Automaticlast 30 days in full, then daily → weekly → monthly (~60–90)~2.5–3.5 GB

Automatic keeps more than a limit of 5 and less than 100 in this case, but distributes what it keeps across the whole 14 months instead of stacking it at the end.

Applying either one to what already exists

Connect-SPOService -Url https://contoso-admin.sharepoint.com

# Tenant default for new libraries: automatic
Set-SPOTenant -EnableVersionExpirationSetting $true -EnableAutoExpirationVersionTrim $true

# Apply to an existing site (new files) ...
Set-SPOSite -Identity https://contoso.sharepoint.com/sites/Finance -EnableAutoExpirationVersionTrim $true

# ... and trim what is already there, after the report
New-SPOSiteFileVersionExpirationReportJob -Identity https://contoso.sharepoint.com/sites/Finance -ReportUrl 'https://contoso.sharepoint.com/sites/Finance/Shared Documents/report.csv'
New-SPOSiteFileVersionBatchDeleteJob -Identity https://contoso.sharepoint.com/sites/Finance -Automatic

Swap -Automatic for -MajorVersionLimit 20 -MajorWithMinorVersionsLimit 0 for a hard-limit trim. Both are permanent.

A sensible policy

  1. Tenant default: automatic. Safe to switch on without per-library analysis.
  2. Compliance libraries: hard limit set to the number in the policy document, via PowerShell if it is below 100.
  3. Before any trim of existing versions: a what-if. The expiration report CSV, or a tool that shows per-library what a policy would delete and in GB. TrimVersions365's What-if tab is that, and its execute step never touches the current version or the file itself.

Questions people also ask

What is intelligent versioning in SharePoint?

An automatic version-history mode that keeps every version from the last 30 days, then progressively fewer as versions age (daily for a period, then weekly, then monthly), instead of keeping a fixed number.

Is intelligent versioning on by default?

For new tenants and new libraries it is the default. Existing libraries keep whatever limit they had until an admin applies the setting and, optionally, a trim job to existing versions.

Which is better, a version limit or automatic versioning?

Automatic is safer to switch on without analysis and reclaims most of the space. A hard limit is simpler to explain to auditors and guarantees a maximum count. Many tenants use automatic tenant-wide and a hard limit only on specific compliance libraries.

Can I recover versions deleted by version trimming?

No. Trimmed versions are permanently deleted and do not go to a recycle bin. Run the expiration report or a what-if first.