Skip to content
Developer Codex
Navigation & Search

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.

The event log captures changes across all major areas of your workspace:

EventWhat it records
Page createdTitle at creation time
Page updatedMetadata changes
Page renamedBefore and after title
Page movedMovement to a new parent
Page deletedSoft-delete timestamp
Page restoredRestoration from Trash
Block content savedContent changes (classified as “content change”)
Tag assigned to pageWhich tag was added
Tag removed from pageWhich tag was removed
Attachment uploadedAttachment creation

Events are recorded automatically. There is no opt-in and nothing to configure to start capturing history.

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".

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.

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.

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.

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.

  • 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?