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

# Activity Log

> Track every meaningful change to a career in SkillsDB — people assigned or removed, skill changes, training updates, level edits, and more — with a filterable, time-stamped audit trail and built-in notification and re-approval actions.

<Info>
  **Quick Summary:** The Career Activity Log is a time-stamped, filterable record of every change made to a career. Administrators open it from the Careers library to see who assigned people, edited skills, changed training settings, or updated levels — and can trigger downstream actions like notifying affected users or forcing training re-approval directly from the log.
</Info>

# Overview

The Activity Log gives administrators a complete audit trail of every change that happens to a career. Every time someone is assigned to the career, a skill is added or edited, a training setting is updated, a level is changed, or a label is applied, the event is captured with a timestamp, the person who performed the action, and the details of what changed.

The log is purpose-built for two jobs:

* **Accountability.** Answer the question "who changed what, when?" during an audit, an investigation, or a customer-support ticket.
* **Downstream action.** Some changes (like editing a skill or a training setting) ripple out to people assigned to the career. The log provides built-in actions to notify those people or force training re-approval without leaving the page.

Career activity is administrator-only. Managers and employees do not have access to the Activity Log for a career.

<Note>
  **Note:** A company-wide activity log covering the entire organization is on the SkillsDB roadmap. Until it ships, the Activity Log is scoped to a single career at a time — open the log for any career from the Careers library.
</Note>

***

## Prerequisites

Before you open the Activity Log, you need:

* **Permission level:** Administrator role in SkillsDB
* **Setup requirement:** At least one career in your Careers library
* **Access:** Navigate to **Library > Careers** from the left sidebar

Non-admin users who navigate to a career activity URL are redirected back to the Careers library.

***

## Opening the Activity Log

<Steps>
  <Step title="Open the Careers library">
    Navigate to **Library > Careers** from the left sidebar.
  </Step>

  <Step title="Open a career's activity page">
    Select the career whose activity you want to review. From the career details panel, select the **Activity** action. The URL changes to `/manage/careers/activity/[careerId]` and the breadcrumb reads **Activity / \[Career Name]**.
  </Step>

  <Step title="Switch between careers">
    The breadcrumb includes a career picker — select the combobox next to the career name to jump to any other career's activity log without navigating back to the library.
  </Step>
</Steps>

***

## Reading the Log

The Activity Log is a table of events, newest first. Each row captures one discrete change.

### Columns

| Column                | Description                                                                                                                                      |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Event type**        | A colored badge summarizing the category — People, Skill, Section, Training, Level, Label, Flag, and others. Badge color indicates the category. |
| **Event description** | A human-readable summary of what happened, with the relevant entity (person, skill, section, etc.) named inline.                                 |
| **Performed by**      | The administrator who made the change, shown with their name, email, and avatar. Events made through the API display an **API** badge.           |
| **Performed at**      | The date and time the change occurred.                                                                                                           |
| **Affected count**    | For bulk actions — the number of people, skills, or related items touched by the single event.                                                   |
| **Actions**           | Any follow-up actions available for that event, such as **Notify** or **Force re-approval**.                                                     |

### Event categories

Activity events fall into category groups, each with its own badge color:

| Category     | Badge color | Example events                                                          |
| ------------ | ----------- | ----------------------------------------------------------------------- |
| **People**   | Blue        | Person assigned to the career, person removed, bulk assign, bulk remove |
| **Skill**    | Green       | Skill added, skill edited, training setting changed on a skill          |
| **Training** | Cyan        | Learning resource linked, unlinked, or updated                          |
| **Section**  | —           | Section created, renamed, reordered, or removed                         |
| **Level**    | —           | Level created, renamed, reordered, or removed                           |
| **Label**    | —           | Label applied to the career, label removed                              |
| **Flag**     | —           | Skill flag or career-level flag assigned or removed                     |

<Info>
  **Note:** Bulk actions (like assigning 50 people at once) are collapsed into a single log entry with an **Affected count** so the log stays scannable. Expand the row to see the individual people or items involved.
</Info>

***

## Filtering and Searching

The Activity Log supports filtering to help you zero in on the events that matter.

* **Date range** — use the date picker to scope the view to a specific window (the default lookback is a broad recent range). Options include common ranges like the last 7 days, last 30 days, and this month, plus a custom start/end.
* **Event type** — filter to one or more event categories (People, Skill, Training, etc.) when you only want to see activity of a certain kind.
* **Performed by** — filter by the administrator who made the changes, useful for reviewing one person's activity.

Combine filters freely. The table updates as you change each filter, and the result count in the header reflects the filtered set.

***

## Taking Action from the Log

Some events have a direct impact on users assigned to the career — for example, editing a skill's name or its training requirements. The Activity Log lets administrators act on those events without leaving the page.

### Notify users

The **Notify** action sends an email to a selected audience explaining that a change occurred. Available targets:

| Target                                       | Who receives the notification                                              |
| -------------------------------------------- | -------------------------------------------------------------------------- |
| **All assigned**                             | Every user currently assigned to the career                                |
| **All assigned, without training approval**  | Users who have not yet received training approval for the affected skill   |
| **All assigned, with training approval**     | Users who have training approval (to let them know the definition changed) |
| **All assigned, awaiting training approval** | Users with submitted-but-pending training approval requests                |
| **Experts only**                             | Users flagged as Expert on the affected skill                              |

Notifications are sent immediately and recorded in the log with an **Email Sent** indicator.

### Force training re-approval

The **Force re-approval** action resets training-approval status on an affected skill so users must submit training approval again. Available targets:

| Target                                       | Who is forced to re-approve                                           |
| -------------------------------------------- | --------------------------------------------------------------------- |
| **All assigned, with training approval**     | Users whose training approval will be revoked, requiring resubmission |
| **All assigned, awaiting training approval** | Users whose pending training approval requests are reset              |

<Warning>
  **Warning:** Force re-approval resets training status for the selected audience. People will need to submit training approval again, and until they do, their training status for that skill will show as pending. Use this action only when a skill change is significant enough to warrant re-verification.
</Warning>

Both actions are logged in the Activity Log as new entries, preserving the full chain of cause-and-effect — the original change, the admin's decision to notify or force re-approval, and any follow-up.

***

## Common Questions

<AccordionGroup>
  <Accordion title="Who can see the Activity Log?">
    Only administrators can open the Activity Log. Managers and employees do not have access. Non-admin users navigating directly to the activity URL are redirected back to the Careers library.
  </Accordion>

  <Accordion title="Is the Activity Log immutable?">
    Yes. Log entries cannot be edited or deleted. This is intentional — the audit trail must remain tamper-proof to serve as reliable evidence during audits, compliance reviews, and support investigations.
  </Accordion>

  <Accordion title="Does the Activity Log capture changes made through the API?">
    Yes. API-driven changes appear in the log with an **API** indicator next to the performer. This makes it easy to distinguish between changes made in the SkillsDB UI and changes made by automation or integrations.
  </Accordion>

  <Accordion title="Is there a company-wide activity log covering every career?">
    Not yet. Today the Activity Log is scoped to one career at a time. A company-wide activity page that aggregates activity across all careers and other areas of the product is on the roadmap.
  </Accordion>

  <Accordion title="What's the difference between the Activity Log and Version History?">
    Version History is a per-skill record of changes to the skill's name and description — it captures what the skill definition looked like at each point in time. The Activity Log is a per-career record of every meaningful event that touches the career — people assigned, skills added or edited, training settings changed, levels reordered, and so on. Use Version History when you care about the content of a specific skill over time. Use the Activity Log when you care about everything that happened to a career.
  </Accordion>

  <Accordion title="Can I export the Activity Log?">
    Yes. The Activity Log table supports standard SkillsDB export — use the export action in the table header to download the filtered view as a spreadsheet. This is useful for compliance reports or shared investigations.
  </Accordion>

  <Accordion title="Why does a log entry show 'Email Sent' or 'Email Disabled'?">
    The **Email Sent** column captures whether a notification email went out for that event. If the customer-side email integration was disabled at the time the event occurred, the row is marked **Email Disabled** — this helps explain why an expected notification did not reach users.
  </Accordion>
</AccordionGroup>

***

## Related Articles

<CardGroup cols={2}>
  <Card title="Version History" icon="link" href="/core-concepts/version-history">
    Review the per-skill history of name and description changes, with a built-in Renew Training action
  </Card>

  <Card title="Career Settings" icon="link" href="/configurations/career-settings">
    Configure measurement model, training dates, assessments, and dashboard per career
  </Card>

  <Card title="Training Approvals" icon="link" href="/core-concepts/training-approvals">
    How training approval works and how Activity Log actions can reset approval status
  </Card>

  <Card title="Careers Library" icon="link" href="/libraries/careers">
    Browse and manage all careers in your organization
  </Card>
</CardGroup>

***

## Need Help?

<Info>
  If you run into any issues or have questions, reach out to your organization's SkillsDB administrator or contact [SkillsDB Support](https://www.skillsdb.com/support).
</Info>
