---
title: "Track every change to your packages with package logs"
description: "Package logs are now available in the Cloudsmith web app, giving you a per-package audit trail: what changed, who changed it, and when."
canonical_url: "https://cloudsmith.com/changelog/track-every-change-to-your-packages-with-package-logs"
last_updated: "2026-09-14T10:05:01.656Z"
---
# Track every change to your packages with package logs

Package logs are now available in the Cloudsmith web app, giving you a per-package audit trail: what changed, who changed it, and when.

## How it works

Package logs sit alongside client and audit logs under **Logs** in the Cloudsmith web app:

```json
{
  "_key": "ddc75e40dfdc",
  "_type": "image",
  "alt": "The package logs view in the Cloudsmith web app.",
  "asset": {
    "_createdAt": "2026-09-14T10:03:34Z",
    "_id": "image-eafe3e527366c5c404d6b1539ba85a2135d1c9c3-1789x550-png",
    "_rev": "gQ3ZJidoYVcWmwXzV2nkCr",
    "_type": "sanity.imageAsset",
    "_updatedAt": "2026-09-14T10:03:34Z",
    "assetId": "eafe3e527366c5c404d6b1539ba85a2135d1c9c3",
    "extension": "png",
    "metadata": {
      "_type": "sanity.imageMetadata",
      "blurHash": "DBS$r,ozxY-pM|~qRjNGWEt7",
      "dimensions": {
        "_type": "sanity.imageDimensions",
        "aspectRatio": 3.252727272727273,
        "height": 550,
        "width": 1789
      },
      "hasAlpha": true,
      "isOpaque": false,
      "lqip": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAGCAYAAADDl76dAAAACXBIWXMAAAsSAAALEgHS3X78AAAAzUlEQVQYlYWP204EQQhE5/8/Vld3mlsBZehxJ/pgfDgJgeZ0caiDYuApvplaHJy+R9Ki6ChGNrP4L4cDtAiK+sYCDCSRxaxmDT2Q/Qf1oz48goFL8mJkyN6pcFPMzfcnxZus3rPpH2pGZO4UWbWFk9I8eVrxqUVRUNWuCxwEZvkl7GvHgxHJw9xv4TBJZqgGfkjxfRVPCa4lPJdQbN7Xr5OB5ASLwBY2MrvIrqoOZKt5i0Y/Vvbbmf0U7+da/XmuFrXOuZu8CaBVtd29vwD5ZdhafuKbWgAAAABJRU5ErkJggg==",
      "palette": {
        "_type": "sanity.imagePalette",
        "darkMuted": {
          "_type": "sanity.imagePaletteSwatch",
          "background": "#1d457b",
          "foreground": "#fff",
          "population": 0,
          "title": "#fff"
        },
        "darkVibrant": {
          "_type": "sanity.imagePaletteSwatch",
          "background": "#193b6b",
          "foreground": "#fff",
          "population": 0,
          "title": "#fff"
        },
        "dominant": {
          "_type": "sanity.imagePaletteSwatch",
          "background": "#c4d7f1",
          "foreground": "#000",
          "population": 0.45,
          "title": "#000"
        },
        "lightMuted": {
          "_type": "sanity.imagePaletteSwatch",
          "background": "#dcb4b4",
          "foreground": "#000",
          "population": 0.01,
          "title": "#fff"
        },
        "lightVibrant": {
          "_type": "sanity.imagePaletteSwatch",
          "background": "#c4d7f1",
          "foreground": "#000",
          "population": 0.45,
          "title": "#000"
        },
        "muted": {
          "_type": "sanity.imagePaletteSwatch",
          "background": "#78807a",
          "foreground": "#fff",
          "population": 0.03,
          "title": "#fff"
        },
        "vibrant": {
          "_type": "sanity.imagePaletteSwatch",
          "background": "#3073ce",
          "foreground": "#fff",
          "population": 0,
          "title": "#fff"
        }
      },
      "thumbHash": "/veBAoAPwAs9YWT0lyR/R4eHf4iA9wg="
    },
    "mimeType": "image/png",
    "originalFilename": "packageLogs.png",
    "path": "images/rafvlnhi/production/eafe3e527366c5c404d6b1539ba85a2135d1c9c3-1789x550.png",
    "sha1hash": "eafe3e527366c5c404d6b1539ba85a2135d1c9c3",
    "size": 162399,
    "uploadId": "21a9276edf4b3f2ebe654702175ae04eceacdc57",
    "url": "https://cdn.sanity.io/images/rafvlnhi/production/eafe3e527366c5c404d6b1539ba85a2135d1c9c3-1789x550.png"
  },
  "link": {
    "_type": "link",
    "href": null,
    "openInNewTab": false
  },
  "markDefs": null
}
```

Each entry records a timestamp, an action, the actor who performed it, and the affected package and version, plus detailed metadata such as package size and actor IP address. 

You can filter the logs by action, target, and actor to isolate a single event or narrow an investigation.

Cloudsmith creates package logs for the following actions:

- Copy
- Delete
- Hard delete
- Move
- Policy violation
- Quarantine
- Restore
- Resync
- Sync
- Tags changed

Package downloads are recorded in client logs.

For more details, see [Package logs](https://docs.cloudsmith.com/logs-and-observability/package-logs) in the Cloudsmith documentation.