Documentation
Audit Log
Every change made in Studio is recorded with who made it and when. The audit log gives your team a complete history of what changed, who changed it, and what the value was before. Available to workspace members on Pro.
What is recorded
Each log entry captures:
- •Timestamp. When the change occurred, in UTC.
- •Actor. The team member who made the change. Shown as "Unknown" if the member has since been removed.
- •Action. The type of change (created, updated, deleted, and so on).
- •Entity type and label. What was changed and its name at the time of the change.
- •Before / After. A snapshot of the previous and new state. Null for creations (no before) and deletions (no after).
Bulk token save operations record the action and timestamp only. Before/after snapshots are not captured for bulk saves.
Event taxonomy
Each log entry has two dimensions: the action taken and the entity it affected.
Actions
- •
create— Created. A new entity was added. - •
update— Updated. An existing entity's value or properties changed. - •
delete— Deleted. An entity was permanently removed. - •
merge— Merged. A branch was merged into main. - •
publish— Published. A new version was published. - •
rollback— Rolled back. A publish was reverted to a previous version. - •
cherry_pick— Cherry-picked. One or more token changes were selectively applied from a branch. - •
settings_change— Settings changed. A project or org setting was modified.
Entity types
- •
token— A single design token. - •
component— A component defined in the component builder. - •
mode— A token mode, for example dark or compact. - •
mode_override— A context-specific override applied to a mode. - •
branch— A feature branch. - •
version— A published release. - •
project— The project itself, for example its name or settings. - •
member— A team member in the organization. - •
invite— A pending invitation to the organization. - •
api_key— An API key. - •
org— The organization, for example org-level settings. - •
user_2fa— Two-factor authentication setup for a member.
Retention
Log entries are retained for 90 days on Free and 365 days on Pro. Entries older than your plan's retention window are removed automatically.
Note: retention periods are pending PM confirmation. The values above are placeholders and must be updated before this page goes live.
Plan access
The audit log is available on Pro. Project-level logs show every change made within a single workspace. Pro workspaces also have access to organization-level logs, which aggregate events across all workspaces in your organization.
Note: Free plan access and org-level log availability are pending PM confirmation. Update this section before this page goes live.
For a full breakdown of what's included on each plan, see Pricing and Payments.
Exporting
To download a CSV of your audit log:
- Open Studio and navigate to your project's Settings.
- Select "Audit Log" from the settings sidebar.
- Optionally apply filters to narrow the export. You can filter by entity type, team member, action, or date range.
- Click "Download CSV" in the top-right corner.
The CSV includes all matching entries, not just the visible page. It contains four columns: timestamp (ISO 8601, UTC), action, actor, and details. Clear all filters before exporting to get the full history.
To see how branch events appear in the log, see Branching Workflow. For plan details, see Pricing and Payments.