Age out documents older than n days Including documents with pending uploads
Explanation
This policy controls when locally cached Office documents are aged out of the Office Document Cache including if the file may have pending uploads. This acts as a maximum possible age (in days) for any file to remain in the Office Document Cache.
If you enable this policy setting, files older than the policy "Age out documents older than n days" as well as this setting will get cleaned up regardless of file pending upload status.
If you disable this policy setting or if you do not configure this policy setting, Office will clean out only files that do not have pending changes per the policy "Age out documents older than n days". Configuring this policy with a value of 0 is also considered disabling the policy.
For more information https://support.microsoft.com/en-us/topic/managing-office-document-cache-size-ea64af72-b597-408e-8ecf-fd55daa02476
Note: This policy setting only applies to Office builds 19328.20000 and newer
Registry
HKEY_CURRENT_USER\software\policies\microsoft\office\16.0\common\fileio- Value name
- not defined in the ADMX
Enable / disable values: not defined in the ADMX (see the options below).
PowerShell
PowerShell commands that write to the registry what the policy would write. Values in angle brackets (<…>) must be replaced.
Writing directly to the registry bypasses Group Policy: if a GPO manages this value, it will be rewritten at the next gpupdate; otherwise the value stays in place (the "tattooing" effect). Prefer a GPO or, locally, LGPO.exe. Run PowerShell as administrator for HKLM. Some policies need a restart or gpupdate /force.
Enable
# Enable: office16/L_AgeOutPolicyIncludingFilesPendingUpload
$k = 'HKCU:\software\policies\microsoft\office\16.0\common\fileio'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Number of days
Set-ItemProperty -Path $k -Name 'ageoutpolicyincludingfilespendingupload' -Value 0 -Type DWord # between 0 and 365Disable
# Disable: office16/L_AgeOutPolicyIncludingFilesPendingUpload
# No value is written in the "Disabled" state (nothing defined in the ADMX)Revert to "Not configured"
# Revert to "Not configured": office16/L_AgeOutPolicyIncludingFilesPendingUpload
$k = 'HKCU:\software\policies\microsoft\office\16.0\common\fileio'
Remove-ItemProperty -Path $k -Name 'ageoutpolicyincludingfilespendingupload' -ErrorAction SilentlyContinueOptions (1)
| Label | Control | Registry value | REG type | Constraints / details |
|---|---|---|---|---|
| Number of daysL_AgeOutPolicyIncludingFilesPendingUploadDecimal | Numeric boxdecimal | ageoutpolicyincludingfilespendingupload | REG_DWORD | Min: 0 · Max: 365 |
Application
Microsoft 365 Apps / Office (Microsoft) — November 2026 templates
Official templates downloaded on November 12, 2026.