Skip to content

Revisions

AI Context Items support full revision history, allowing you to track changes over time and revert to previous versions if needed.

Every save creates a revision

Context items are moderated by the ai_context_editorial workflow, and Content Moderation creates a new revision on every save. The Create new revision checkbox on the context item form is therefore always checked and locked, and there is no setting to turn revisions off. Use the revision log message to describe each change.

Viewing revisions

Each context item has a Revisions tab at /admin/config/ai/context/items/{id}/revisions that shows a chronological list of all revisions, including:

  • Revision timestamp
  • Revision author
  • Timestamp
  • Author
  • Log message
  • Current vs. previous status

Reverting a revision

From the revision history, you can revert any context item to a previous revision. This creates a new revision with the old content, preserving the full history.

Reverting requires the Revert all AI Context Item revisions permission.

Deleting a revision

Individual revisions can be deleted from the history (except the current revision). This requires the Delete all AI Context Item revisions permission.

Diff integration

When the Diff module is installed, you can compare revisions side-by-side. The module provides custom diff field builders for:

  • Specific entities fields -- shows changes to entity item associations (requires Dynamic Entity Reference)
  • Scope field -- shows changes to scope value selections

The diff integration is automatically enabled when the Diff module is installed. No additional configuration is required.

Revision and moderation

Each moderation state change (draft to published, or vice versa) creates a new revision. Combined with revision log messages, this provides a complete audit trail of the editorial workflow.