# 3. Configuration

The plugin configuration is located under **Extensions → My Extensions → Admin Activity Log → Configure**.

![Plugin configuration page with entity scope, retention period, and system actions toggle](https://459847022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-1972196547%2Fuploads%2Fgit-blob-8382ea167b06943d7b4b895e4c69b340e135c693%2F5.png?alt=media)

## Tracked Entities

| Setting    | Value                                          |
| ---------- | ---------------------------------------------- |
| Config key | `trackedEntities`                              |
| Default    | Products, Orders, Customers, Categories, Media |
| Type       | Multi-select                                   |

Choose which entity types should be tracked in the activity log. Changes to unselected entities are not logged.

Available entity types:

* Products
* Orders
* Customers
* Categories
* Media
* Manufacturers
* Properties
* Shipping Methods
* Payment Methods
* Sales Channels
* CMS Pages

**Note:** Changes take effect immediately for new log entries — no cache flush or restart required. Existing log entries for deselected entities are preserved.

**Note:** Order, delivery, and payment status transitions are captured automatically regardless of whether "Orders" is selected. Third-party plugins can register additional entities — see [Developer Extension API](https://docs.momocode.de/en/shopware-6/admin-activity-log/5.-extension).

## Retention Period

| Setting    | Value           |
| ---------- | --------------- |
| Config key | `retentionDays` |
| Default    | 90 days         |
| Type       | Single-select   |

Configure how long log entries are retained before automatic deletion.

| Option      | Description                                                |
| ----------- | ---------------------------------------------------------- |
| 30 days     | Entries older than 30 days are deleted daily               |
| 60 days     | Entries older than 60 days are deleted daily               |
| **90 days** | **Default** — entries older than 90 days are deleted daily |
| 180 days    | Entries older than 180 days are deleted daily              |
| 365 days    | Entries older than 365 days are deleted daily              |
| Unlimited   | No automatic deletion                                      |

Cleanup runs daily via a scheduled task. Expired entries are removed together with all associated field change records.

## Log System Actions

| Setting    | Value              |
| ---------- | ------------------ |
| Config key | `logSystemActions` |
| Default    | enabled            |
| Type       | Boolean (yes/no)   |

Controls whether writes triggered by the following sources are logged:

* CLI commands (`bin/console`)
* Scheduled tasks
* API integrations without a logged-in admin user

**Enabled (default):** All writes are logged regardless of their source. API integrations appear with the integration name and an "Integration" badge.

**Disabled:** Only changes directly triggered by a logged-in admin user appear in the log.

**Note:** Login events are always logged regardless of this setting.
