Skip to content

Document Content History retention and version creation scope - #3386

Open
derrickmehaffy wants to merge 4 commits into
mainfrom
cms/document-content-history-retention
Open

Document Content History retention and version creation scope#3386
derrickmehaffy wants to merge 4 commits into
mainfrom
cms/document-content-history-retention

Conversation

@derrickmehaffy

Copy link
Copy Markdown
Member

This PR documents two Content History behaviors that the documentation did not cover at all, both of which support currently has nothing to cite when customers ask.

  • Adds a "How versions are created" section stating that versions are only created for content edited through the Content Manager, with a table covering the REST API, the GraphQL API, the Document Service API, lifecycle hooks, cron jobs, and the strapi import and strapi transfer commands
  • Adds a "Version retention" section covering the daily deletion job, the fact that expired versions are permanently deleted and cannot be recovered from the interface, and the 90-day maximum
  • Documents the history.retentionDays parameter on the admin panel configuration page, mirroring the existing auditLogs.retentionDays entry, and adds it to the full configuration examples
  • Removes a misplaced copy of the audit logs retention note that sat under the Transfer tokens section, where it referred to an unrelated parameter

Behavior was verified against packages/core/content-manager/server/src/history in strapi/strapi.

derrickmehaffy and others added 4 commits August 21, 2026 11:45
Content History had no retention section at all, so there was no way to
answer how long versions are kept, and nothing stated that versions are
only created for edits made through the Content Manager. Writes from the
REST and GraphQL APIs, the Document Service API, lifecycle hooks, cron
jobs, and the import and transfer commands create no version.

Co-Authored-By: Claude <noreply@anthropic.com>
The parameter controls how long Content History versions are kept but was
never documented, unlike the analogous auditLogs.retentionDays. Adds it to
the full configuration examples and states that it can only shorten the
retention period defined by the license.

Co-Authored-By: Claude <noreply@anthropic.com>
The note duplicates the one under the Audit logs section and refers to
auditLogs.retentionDays, which is unrelated to transfer tokens.

Co-Authored-By: Claude <noreply@anthropic.com>
The TL;DR feeds llms.txt, so surfacing the 90-day maximum and the Content
Manager scope there makes both facts reachable without reading the page.

Co-Authored-By: Claude <noreply@anthropic.com>
@vercel

vercel Bot commented Aug 21, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
documentation Ready Ready Preview Aug 21, 2026 7:01pm

Request Review

@github-actions github-actions Bot added pr: updated content PRs updating existing documentation content source: CMS labels Aug 21, 2026
@github-actions github-actions Bot added the internal PRs created by the Strapi core team label Aug 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

internal PRs created by the Strapi core team pr: updated content PRs updating existing documentation content source: CMS

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant