README.md

Custom Version View plugin

This plugin introduces additional fields to the version view for a more detailed and informative experience:

• 🕒 Updated At: Displays the relative date of the last update, making it easy to track when changes were made (e.g., "3 hours ago").

• 👤 Updated By: Shows the user who made the last update.

https://github.com/user-attachments/assets/f3e79c7d-277c-4ec6-b5b9-c91b0e104286

Install

Install the plugin using your node package manager, e.g:

pnpm add @shefing/custom-version-view

Setup

In the payload.config.ts add the following:

  plugins: [
    ...plugins,
    versionsPlugin({
      excludedCollections: [] //array of collections names to exclude
      excludeGlobals:[] //array of globals names to exclude
    })

The updated by field in versions relies on the authors-info package.

Collection Configuration

Add the following configuration to enable versions for a collection:

  versions: {
    drafts: true,
  }

Roadmap

See the consolidated ROADMAP.md at the repo root and the live RoadMap issues for Custom Version View.

P0 — user-requested

• Configurable list columns — listFields: string[] (plugin-level default) + collection.custom.versionListFields (per-collection override). Resolves dotted paths the same way QuickFilter will.
• Per-column renderers — { name, label, width, Cell } objects so users can drop in custom React cells (status pill, avatar, etc.).

P1

• Filtering & search on the versions list (status, author, date range) — natural pairing with QuickFilter.
• Compare any two versions (currently only "vs published"); restore-with-diff confirmation.
• Group by day / author toggle.
• Pagination + virtualization for collections with thousands of versions.

P2

• Export a single version as JSON.
• Color-coded change indicator (added / removed / changed counts) per row, reusing the changes-button diff pipeline.