> ## Documentation Index
> Fetch the complete documentation index at: https://beebole.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Audit trail: track every change in your account

> Beebole's audit trail records who changed what and when. Administrators see each change in the Journal of the item it touched, and older weeks through the API.

Beebole's audit trail records the changes made to your account's data: what changed, who made the change, and when. It gives administrators an accountable history of edits to people, projects, tasks, time entries, and configuration, so you can trace a modification back to a person and a moment in time.

<Info>
  The audit trail is not available on the **Free** plan. It is part of the **Essential** and **Advanced** plans and of the free trial. If you don't see it, check your [subscription](/help/documentation/subscription).
</Info>

## Where to find the audit trail <Badge>Admin only</Badge>

Each change appears in the **Journal** of the item it touched, next to the messages posted on that item. The **Journal** in the sidebar does not list these changes.

<Steps>
  <Step title="Open the item">
    Open the person, project, task, tag, role, work schedule, time off type, expense type, or custom field whose history you want to see. For example, click **People** in the sidebar, then click the person.
  </Step>

  <Step title="Switch to its Journal">
    Click **Show journal**, the button at the top right of the item's panel. Click it again (**Show attributes**) to return to the item's settings.
  </Step>

  <Step title="Read the changes">
    Changes are listed newest first, each with who made it and how long ago.
  </Step>
</Steps>

For changes to the account's own settings, open **Account Settings** and click **Show journal** there.

A person's **Journal** also lists the time records added, copied, edited, or deleted on their timesheet, and the changes to who manages them or what they manage.

<Frame caption="A person's Journal listing the changes made to her records">
  <img src="https://mintcdn.com/beebole/iz40sgfW8N-hZfKM/help/images/journal/activity-feed.webp?fit=max&auto=format&n=iz40sgfW8N-hZfKM&q=85&s=d2fac6ca328e7ff209b99a21a4fed74a" alt="Beebole Journal of the person Ana Pereira, opened from her profile, with the message editor and its formatting toolbar at the top and the feed below listing an added expense record and added time records for PTO and Sickness days, each with who made the change and when" width="598" data-path="help/images/journal/activity-feed.webp" />
</Frame>

<Info>
  Only administrators see change entries. Other people who open an item's **Journal** see its messages, not its change history.
</Info>

## What each entry shows

Each entry is named after the change it records, so you can read the history without opening anything. When the change involves another item, the entry names it too.

| Entry | What it records |
| - | - |
| **Name change**, **Description change**, **Color change** | The item was renamed, or its description or color changed |
| **Parent change** | The item was moved under another parent |
| **Changed role to** | A person's role changed, followed by the new role |
| **Tagged with**, **Untagged from** | A tag was added to or removed from the item, followed by the tag |
| **Done**, **Reopened** | A task was marked done or reopened |
| **Archived**, **Unarchived** | The item was archived or brought back |
| **Added time record**, **Copied time record**, **Edited time record**, **Deleted time record** | A time entry on the person's timesheet was added, copied, changed, or deleted |

Time entry changes spell out the duration, the project, task, or time off type, and the date of the entry. On an edit, the changed value shows as old → new, for example *Edited time record: 2h → 3h30 · Acme Corp, Website Redesign · 2026-10-05*. Durations follow your account's duration format.

### Show one kind of change

Click a change entry to show only the changes of the same kind, such as every **Tagged with** and **Untagged from** entry on a person. Messages stay visible. Click the entry again to show everything.

### Changes made while signed in as someone else

When an administrator uses **Sign in as…** and changes something on another person's behalf, the entry names the administrator who made the change, not the person they were signed in as. See [Sign in as another person](/help/documentation/authentication#sign-in-as-another-person).

## Look further back

The **Journal** shows the changes of the last 7 days. To look at an earlier week, or to list every change one person made, use one of these:

* The [Beebole API](/help/api/queries): the `getAuditTrails` query returns a 7-day window starting at the `startTime` you pass, and `fromPersonId` limits it to the changes made by one person.
* A [connected AI assistant](/help/integrations/mcp-server): ask it who changed something in a given week, or for every change a person made. It reads the same audit trail.

Both work only for administrators, on plans that include the audit trail.

## Related content

<CardGroup cols={2}>
  <Card title="Journal" icon="comments" href="/help/documentation/journal">
    Post messages, follow team activity, and filter the feed.
  </Card>

  <Card title="Roles & permissions" icon="user-shield" href="/help/documentation/roles-authorisations">
    Control who has admin access to view audit activity.
  </Card>

  <Card title="API queries" icon="code" href="/help/api/queries">
    Read the audit trail and other account data with the GraphQL API.
  </Card>

  <Card title="Data Exports" icon="file-export" href="/help/documentation/data-exports">
    Export your organization's data for reporting and record-keeping.
  </Card>
</CardGroup>

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Does Beebole's audit trail show the previous value of a field?">
    For time entries, yes: an edited entry shows the changed value as old → new, along with the entry's duration, project or task, and date. For other items, Beebole names the kind of change, such as **Name change** or **Changed role to**, with who made it and when, but does not show the old and new values side by side.
  </Accordion>

  <Accordion title="Where do I see audit activity in Beebole?">
    In the **Journal** of the item that changed: open a person, project, task, tag, role, work schedule, time off type, expense type, or custom field and click **Show journal**. Changes to the account's settings are in the **Account Settings** journal. Only administrators see change entries, and the **Journal** in the sidebar does not list them.
  </Accordion>

  <Accordion title="How far back can I see changes in Beebole?">
    Beebole shows the last 7 days of changes in each item's **Journal**. For an earlier week, an administrator can query the audit trail through the Beebole API with `getAuditTrails` and a `startTime`, or ask a connected AI assistant.
  </Accordion>

  <Accordion title="Does the audit trail record who viewed data, or only changes?">
    Only changes. Beebole's audit trail records actions that modify data, such as adds, edits, and removals. It does not track who viewed or accessed a record. Changes made by someone who was later archived stay in the audit trail, with their name next to each change.
  </Accordion>

  <Accordion title="Is the audit trail available on every plan?">
    No. Beebole's audit trail is not available on the **Free** plan. It is included in the **Essential** and **Advanced** plans and during the free trial. Review your [subscription](/help/documentation/subscription) if it isn't available.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.