Audit log

Record everything that happens in your workspace, so that you can later see who did what and when.

Audit log is an extra feature, which you can enable by upgrading your workspace to the ENTERPRISE plan.

Enabling audit log #

To start recording actions:

  1. Go to Workspace Settings
  2. Activate audit log
  3. Select change you wish to record (change to time entries, projects, clients, tags)

For example, if you check time entries, you’ll get a record in audit log whenever someone creates a new time entry, edits their existing entry, or deletes it.

Audit log also records cascade changes. For example, if you have a time entry on some project, and that project is updated (e.g. it’s renamed or deleted), you’ll get a record log for both Project updated and for Time entry updated; This only happens if you record both changes in workspace settings. For example, if you record changes to time entries but not to projects, you won’t get a record in audit log when a project is updated.

Running audit #

  1. Go to Workspace settings > Audit tab
  2. Choose date
  3. Choose author
  4. Choose actions
  5. Click Run report

Once you get the report, you can review events in the table (timestamp, user, and action), and expand for more details.

You can also export audit log as a CSV file and analyze it in Excel or some other program.

Because audit log files can be huge, it takes a while to generate them. You can wait and download it once it’s finished, or you can choose to receive it via email within half an hour.

Audit logs older than 1 year are automatically deleted (due to their enormous size). We recommend exporting them each month and storing them personally for archive purposes.

If you’re a self-hosted user, audit logs are never deleted. We recommend exporting them regularly and removing them from Clockify personally.

You can filter audit log by following actions:

Create (personal, timer)CreateCreateCreateCreateCreate (personal)
Create (personal, manual)Create (import)Create (import)Create (import)Create (import)Create (for other)
Create (import)Create (QuickBooks)UpdateCreate (QuickBooks)UpdateUpdate (personal)
Create (for other)UpdateDeleteUpdateDeleteUpdate (for other)
Update (personal)DeleteDeleteDelete (personal)
Update (for other)Delete (for other)
Delete (personal)
Delete (for other)

New and old value in update events #

For update events, you can see more details about what’s been updated.

We recommend enabling audit log from the moment you start using Clockify so you will always have old and new value for update events.

If you use Clockify and enable audit log for some object later, you might not have access to the previous value in the audit log because it wasn’t recording events at that moment.

For example, if you create a time entry while audit log is off, and you later enable it and you update the same entry, audit log will show that it’s been updated but you won’t be able to compare the old and new value. However, if you update that entry again, audit log will show both the previous edit as old value and what exactly has been updated in the new value.