# Changelog Plugin {#changelog-plugin}


Automatically track and log changes to entities in an audit trail.


## Overview {#overview}


The Changelog plugin provides entity-level change tracking — recording who changed what, when, and what the previous values were.


## How It Works {#how-it-works}


The plugin intercepts entity save operations and creates `ActivityLog` records with:

- Changed entity type and ID
- Action type (created, updated, deleted)
- Updated fields and their previous/new values
- Actor (user or system)


## Configuration {#configuration}


The plugin is enabled by default. Configure via environment variables:

| Variable            | Description               | Default |
| ------------------- | ------------------------- | ------- |
| `CHANGELOG_ENABLED` | Enable/disable the plugin | `true`  |


## Usage {#usage}


Once enabled, all entity changes are automatically logged. View the changelog:

1. Navigate to any entity detail page
2. Click the **History** / **Changelog** tab
3. View the chronological list of changes


## Related Pages {#related-pages}


- [Activity Log Endpoints](https://sourcey-gauzy.pages.dev/api/activity-log-endpoints/index.md) — API reference
- [Audit Logging](https://sourcey-gauzy.pages.dev/security/audit-logging/index.md) — security auditing