Audit log
Review workspace and Team configuration, membership, access, and label history
The Audit log shows workspace-owned audit events: workspace member changes, workspace settings changes, Issue/Project/Initiative label configuration, and related security events. Team Audit shows Team lifecycle, membership, policy, and Team-scoped Issue-label configuration. Issue, Project, and Initiative label assignments remain in the affected object's Activity rather than the settings audit.
Project Phase definition and Issue-assignment audit rows keep explicit display-safe old/new snapshots. Project and Issue Activity remain the normal user-facing object history; the centralized log contract provides durable administrative evidence without live rehydration.
The existing /logs routes are retained for stable links. Filters are stored in the URL, so a filtered Audit view can be copied, refreshed, or navigated with browser back and forward without losing its scope.
Actions
View the workspace Audit log
See the history of workspace changes.
- Open Workspace Settings → Audit log
- Browse the chronological list of events (newest first)
- Hover over timestamps for the exact date and time
Only admins can access Workspace Audit. Non-admin members do not see this page in Workspace Settings.
Filter by Category
Focus on specific types of events.
- Open Workspace Settings → Audit log
- Click the Filter dropdown
- Select a category:
- All - Show all workspace log events
- Membership - Workspace join, leave, and role changes
- Account Security - Account security events that affect this workspace
- Settings - Workspace configuration changes such as name, icon, URL, allowed domains, and Project settings
- Planning - Project Phase definition changes
- Labels - Issue, Project, and Initiative label/group configuration
- The log updates to show only matching events
When Labels is selected in Workspace Audit, use the second filter to show all label kinds or only Issue labels, Project labels, or Initiative labels. Team Audit contains only that Team's Issue-label configuration, so Project and Initiative choices are not shown there.
The History action in an Issue, Project, or Initiative label settings page opens the matching Audit route with the relevant label filter already applied.
Understand Log Entries
Each log entry shows:
| Element | Description |
|---|---|
| Icon | Visual indicator of the event type (e.g., user added, role changed) |
| Actor | Who performed the action (avatar + name) |
| Description | What happened (e.g., "changed role from Viewer to Editor") |
| Target | Who or what was affected |
| Timestamp | When it occurred (relative time, hover for exact) |
Event Types
Member Events
| Event | What It Means |
|---|---|
| Member Added | A user joined the workspace (via invite acceptance) |
| Member Removed | A user was removed from the workspace by an admin |
| Role Changed | A member's role was updated (e.g., Viewer → Editor) |
Team lifecycle, Team membership, and Team-owned Issue settings are shown in each Team's Audit log. Issue estimate changes made on individual Issues are shown in Issue Activity.
Settings Events
| Event | What It Means |
|---|---|
| Name Changed | Workspace name was updated |
| Icon Changed | Workspace icon or colour was updated |
| URL Changed | Workspace slug was changed |
| Domains Changed | Allowed email domains were added or removed |
| Label or Group Changed | An Issue, Project, or Initiative label/group was created, renamed, recolored, described, moved, archived, restored, or deleted |
Real-Time Updates
The Audit log updates in real-time. When another authorized user changes workspace configuration or label settings, matching entries appear automatically without refreshing. Workspace Audit listens to workspace permission and Issue/Project/Initiative label scopes; Team Audit listens only to the selected Team's permission and Issue-label scopes.
FAQ
Related
- Managing Members — Understand member events
- Teams — Understand Team lifecycle and membership events
- Security Settings — Understand domain-related events
- Overview — All workspace settings tabs