# Audit Log and Change History

View changes made to entities within a Project.

Only users in Teams with appropriate [permissions](/merchant-center/user-permissions.md#audit-log) can view changes in Audit Log. The permissions are managed by the Administrators Team in your Organization.

Audit Log helps you track and review changes for compliance audits and security investigations, determine the entities that users interact with the most, or identify usage patterns to understand if additional training is required. Note that it does not track read requests made to entities.

Audit Log is available in two versions:

- Basic: tracks changes to [supported entities](/api/history/overview.md#supported-entities) originating from Merchant Center (after 15 March 2021) and stores them for 1 year
- Premium: tracks changes to [supported entities](/api/history/overview.md#supported-entities) originating from Merchant Center and HTTP APIs (after 15 March 2021) and stores them for 3 years

The basic version of Audit Log is available on all Projects, by default. The premium version is subject to additional fees; to purchase, contact your Customer Success Manager. To try the premium version, contact the [commercetools support team](https://support.commercetools.com/) for a trial.

Extended tracking with Audit Log Premium begins only after the premium license is activated.

## Change History

Change History provides you a historical record of changes made to entities in your Project. To view the record of changes, go to **Audit log > Change history**.

The data is generated when the page is loaded and will not be updated automatically. To view the latest data, refresh the page.

Change History tracks user-initiated changes and also changes made by background processes triggered by user actions.

The following are examples of changes initiated by background processes:

- **Change application version** for Discount Codes: the `applicationVersion` property is only used internally to reserve the use of a Discount Code. The value is managed by the Discount Code API and can change at any time due to internal and external factors. It should not be used in customer logic.
- **Change is active** for Product Discounts: the `isValid` property is set to `true` when the `validFrom` date is reached, and then removed after the `validUntil` date is reached.
- **Change review rating statistics** for Products: the `reviewRatingStatistics` property is updated when the reviews of a Product change.
- **Change variant availability** for Products: the `variantAvailability` property is updated when an Inventory Entry related to a Product is updated.
- **Change line item name** for Shopping Lists: the `lineItemName` property is updated (in an [eventually consistent](/api/general-concepts.md#eventual-consistency) manner) when a Product's name is changed and referenced in a Shopping List.

### Change History table

Some columns and filters are only available in Projects with Audit Log Premium or B2B Commerce.

#### Columns

The following table outlines the columns available to you, depending on whether you're using Audit Log Basic, Audit Log Premium, or B2B Commerce.

| Columns |  |  | Basic | Premium | B2B |
| --- | --- | --- | --- | --- | --- |
| Modified by | Merchant Center |  | ✓ |  |  |
|  | API Integration | Change initiated from a general endpoint |  | ✓ |  |
|  |  | Change initiated from a general endpoint with Client logging |  | ✓ |  |
|  |  | Change initiated from an [associate endpoint](/api/associates-overview.md#through-the-associate-endpoint) |  | ✓ | ✓ |
|  |  | Change initiated from an [authenticated Customer](/api/customers-overview.md#customer-authentication-sign-in) |  | ✓ |  |
|  |  | Change initiated from an anonymous user |  | ✓ |  |
|  | System-initiated platform changes |  |  | ✓ |  |
| Action |  |  | ✓ |  |  |
| Changes |  |  | ✓ |  |  |
| Last modified |  |  | ✓ |  |  |
| Current entity |  |  | ✓ |  |  |
| Entity type |  |  | ✓ |  |  |
| Version update |  |  | ✓ |  |  |
| Business unit |  |  |  |  | ✓ |

#### Filters

The following table outlines the filters available to you, depending on whether you're using Audit Log Basic, Audit Log Premium, or B2B Commerce.

| Filter | Basic | Premium | B2B |
| --- | --- | --- | --- |
| Action type | ✓ |  |  |
| Changes | ✓ |  |  |
| Entity ID | ✓ |  |  |
| Entity type | ✓ |  |  |
| Merchant Center user | ✓ |  |  |
| Stores (only available to users with permissions to view or manage [Customers](/merchant-center/user-permissions.md#customers) or [Orders](/merchant-center/user-permissions.md#carts-and-orders)) | ✓ |  |  |
| Business unit |  |  | ✓ |
| API client |  | ✓ |  |
| Customer ID |  | ✓ |  |
| Source |  | ✓ |  |

## Related pages

- [Area overview page with navigation](/merchant-center.md)