Event Log
Every change in your workspace leaves a record. Inklings maintains an append-only event log that captures page creations, renames, moves, deletes, restores, block content saves, tag assignments, and attachment uploads — all with timestamps. It is the audit trail for your world.
What gets recorded
Section titled “What gets recorded”The event log captures changes across all major areas of your workspace:
| Event | What it records |
|---|---|
| Page created | Title at creation time |
| Page updated | Metadata changes |
| Page renamed | Before and after title |
| Page moved | Movement to a new parent |
| Page deleted | Soft-delete timestamp |
| Page restored | Restoration from Trash |
| Block content saved | Content changes (classified as “content change”) |
| Tag assigned to page | Which tag was added |
| Tag removed from page | Which tag was removed |
| Attachment uploaded | Attachment creation |
Events are recorded automatically. There is no opt-in and nothing to configure to start capturing history.
View the event log
Section titled “View the event log”Page timeline
Section titled “Page timeline”Open any page and navigate to the History or Timeline tab in the context panel. The page timeline shows all recorded events for that page, ordered newest-first. The most recent action appears at the top.
The timeline distinguishes two kinds of entries:
- Structural events — page-level changes like renames, moves, tag assignments, and type changes
- Content changes — block content saves, indicating the page body was edited
A rename entry shows both the before and after title: Renamed from "Old Name" to "New Name".
Workspace-wide timeline
Section titled “Workspace-wide timeline”A workspace-wide event log is also available, showing changes across all pages in a configurable time range, ordered oldest-first. This view is useful for reviewing what changed during a specific writing session.
Pagination
Section titled “Pagination”The page timeline and workspace-wide timeline both support limit and offset for navigating large event histories. The default display limit is 50 entries for the page timeline and 200 entries for the workspace-wide view.
What the event log is not
Section titled “What the event log is not”The event log is an audit trail, not a full content undo system. It records that content changed, not every intermediate version of the content. For content-level undo and redo within a page, use the editor’s undo history (Cmd+Z). For named recovery points, use Bookmarks — see Bookmarks and History.
Retention and history collapse
Section titled “Retention and history collapse”By default, Inklings retains events for 90 days. Events older than the retention window are collapsed (removed) by a background task. You can configure the retention period in settings:
- Minimum: 7 days
- Maximum: 3650 days (10 years)
- Default: 90 days
Values outside this range are clamped to the nearest bound. Setting event_log_retention_days to 0 stores it as 7; setting it to 99999 stores it as 3650.
The event_log_summaries table captures summary data from collapsed periods, but detailed event entries are removed once they age past the retention window.
See Also
Section titled “See Also”- Bookmarks and History — Named anchors for important states, distinct from the event timeline
- Trash and Recovery — Page deletion and restoration (both recorded in the event log)
- Search — Find pages by content rather than browsing history
- Sidebar Navigation — Navigate your workspace alongside reviewing its history
Was this page helpful?
Thanks for your feedback!