rilrom

activity log

by rilrom
payload-bites
Logging & monitoring
v3
^3
MIT

Overview

Summary generated from the README

Adds an activity log collection to Payload that records changes made to the collections and globals you choose. Configure it per collection or global, with options to turn off update logging, IP address logging, device info logging and draft autosave logging. The log collection can be customised through an override function. Works with Payload 3.

Features

  • Per-collection and per-global activity logging
  • Optional toggles for update, IP address and device info logging
  • Option to skip draft autosave entries
  • Override function to customize the activity log collection access and admin settings

Use cases

  • Track who changed content across posts, pages and globals
  • Review editorial activity in a reporting group within the admin panel

From the author

keep an eye on everything happening in your cms

Installation

npm i @payload-bites/activity-log

114

Stars

6

Forks

0

Open Issues

3 weeks ago

Last Updated

0

Weekly Downloads

v1.7.0

npm Version

77.4 KB

Unpacked Size

0

Dependencies

Repository stars

Trends appear after 7 days of data. Daily snapshots have not started yet.

Shared by 7 plugins in rilrom/payload-bites.

npm weekly downloads

Trends appear after 7 days of data. Daily snapshots have not started yet.

Each point is npm's rolling 7-day download count.

Health Score

66/100Good

Composite score based on GitHub activity, stars, npm downloads, publish recency, dependency count, and package size.

Badge for your README

Payload Directory health badge
Markdown
[![Payload Directory](https://payloaddirectory.dev/badge/908347705-activity-log.svg)](https://payloaddirectory.dev/plugins/908347705-activity-log)
HTML
<a href="https://payloaddirectory.dev/plugins/908347705-activity-log"><img src="https://payloaddirectory.dev/badge/908347705-activity-log.svg" alt="Payload Directory"></a>
Updated Sep 27, 2026Created Dec 25, 2024Published Jul 15, 2026

README

Activity log

Keep an eye on everything happening in your cms.

Quick start

  1. Install the plugin:
pnpm add @payload-bites/activity-log
  1. Add the plugin to your payload.config.ts:
import { activityLogPlugin } from "@payload-bites/activity-log";

export default buildConfig({
  plugins: [
    activityLogPlugin({
      collections: {
        posts: {},
        pages: {
          enableUpdateLogging: false,
          enableIpAddressLogging: false,
          enableDeviceInfoLogging: false,
        },
      },
      globals: {
        footer: {},
      },
      enableDraftAutosaveLogging: false,
      overrideActivityLogCollection: (collection) => ({
        ...collection,
        access: {
          ...collection?.access,
          update: () => true,
          create: () => true,
        },
        admin: {
          ...collection?.admin,
          group: "Reporting",
        },
      }),
    }),
  ],
});

Defaults

For defaults, refer to defaults.ts.

Options

For options, refer to types.ts.

Roadmap

  • Capture user logins and logouts
  • Record failed login attempts
  • Custom fields in activity log collection
  • Export to CSV or JSON

Similar plugins