# 4. Usage

## Activity Log

The activity log is accessible under **Settings → Extensions → Activity Log**.

![Activity Log listing with filters and user avatars](https://459847022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-1972196547%2Fuploads%2Fgit-blob-de297d6095344123b137026f6dfe87ab6c56c7ef%2F1.png?alt=media)

### Understanding Log Entries

Each log entry contains:

| Column               | Description                                                                                                                        |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| **Date/Time**        | Timestamp of the change                                                                                                            |
| **User**             | User avatar and name of the admin user who made the change; API integrations show the integration name with an "Integration" badge |
| **Entity Type**      | Type of the changed entity (e.g. product, order)                                                                                   |
| **Entity ID / Name** | Human-readable entity name (e.g. product title, order number) with a direct link to the detail page                                |
| **Action**           | Type of change: `created`, `updated`, `deleted`, `login_success`, `login_failed`                                                   |

### Filtering and Searching

Use the filter bar above the list to narrow down entries:

* **Entity Type** — filter by a specific entity type
* **Action** — filter by the type of change
* **User** — filter by a specific admin user or integration
* **Date range** — restrict the time period

The full-text search covers entity name, entity ID, and user name.

### Viewing Field Changes

Click the context menu (three dots) on any row and select **View details** to open a modal showing the field-level before/after values.

![Change detail modal with before/after values for a product update](https://459847022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-1972196547%2Fuploads%2Fgit-blob-21bb68769e540d0522cb7a6f1116a48c7e9fca84%2F2.png?alt=media)

The modal shows for each changed value:

* **Field** — name of the changed field
* **Old Value** — value before the change
* **New Value** — value after the change

For newly created entities, old values are empty; for deleted entities, new values are empty.

### CSV Export

Click **Export CSV** to download the currently filtered entries as a CSV file. The export respects all active filter criteria and contains one row per changed field.

The export format uses UTF-8 with BOM and semicolon as delimiter — compatible with Microsoft Excel. A maximum of 50,000 entries are exported per request.

***

## History on Entity Detail Pages

After activating the plugin, a **"History" button** appears in the toolbar of product, order, customer, and other entity detail pages.

![History modal on a product detail page](https://459847022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-1972196547%2Fuploads%2Fgit-blob-098062f416122e246ecdffb1b119e91acc70b6ea%2F3.png?alt=media)

Click it to view the complete change history for that entity without leaving the current page.

The modal displays all log entries for the entity in an accordion, sorted newest first. Each entry can be expanded to reveal the field-level changes.

The History button is available on the following detail pages:

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

**Note:** The button is only visible when the entity already exists (it does not appear on the create page).

***

## Dashboard Widget

The **"Recent Activity"** widget appears automatically on the admin dashboard and shows the 10 most recent log entries at a glance.

![Admin dashboard with the Recent Activity widget](https://459847022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-1972196547%2Fuploads%2Fgit-blob-8fbc1e0cf07fad062bb969280c762a3572cada53%2F4.png?alt=media)

Each widget entry shows:

* User avatar and name
* Action badge (e.g. "updated", "created")
* Entity type and name with a direct link to the detail page
* Relative timestamp (e.g. "5 minutes ago")

Click **View all** to navigate directly to the full activity log listing.

The widget is only visible to admin users with the `momo_admin_activity_log:read` permission.