Documentation

Audit Log and Change History

Elevate, May 20-22-2025, Miami Beach, Florida

View changes made to entities within a Composable Commerce Project.

Only users in Teams with appropriate permissions 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 originating from Merchant Center (after 15 March 2021) and stores them for 1 year
  • Premium: tracks changes to 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 Composable Commerce support team 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 manner) when a Product's name is changed and referenced in a Shopping List.
To exclude the changes initiated by background processes, click the Display platform-initiated changes toggle.

Change History table

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

Columns

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

ColumnsBasicPremiumB2B
Modified byMerchant Center✓
API IntegrationChange initiated from a general endpoint✓
Change initiated from a general endpoint with Client logging✓
Change initiated from an associate endpoint✓✓
Change initiated from an authenticated Customer✓
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 Composable Commerce for B2B.

FilterBasicPremiumB2B
Action type✓
Changes✓
Entity ID✓
Entity type✓
Merchant Center user✓
Stores (only available to users with permissions to view or manage Customers or Orders)✓
Business unit✓
API client✓
Customer ID✓
Source✓