Timeline and calendar
The timeline tracks your world's history as a sequence of in-world events. The calendar system lets you use in-world dates instead of real-world ones — including homebrew calendars with custom weekdays, months, and year labels.
Adding a timeline event
- Open your world and click Timeline in the sidebar.
- Click + New Event.
- Enter a title and optional description.
- Set the in-world date using year, month, and day fields.
- Choose a category and visibility.
- Mark as Historical (already happened) or Planned (future in-world).
- Optionally link the event to one or more entities.
Events appear on the timeline ordered by in-world date. Planned events display with a distinct style so you can tell at a glance what's history and what's upcoming.
Event categories
Categories let you filter the timeline and color-code events. Available categories include: Battle, Political, Religious, Natural Disaster, Discovery, Death, Birth, Founding, Prophecy, and Custom. Assign any category when creating or editing an event.
Event visibility
Each timeline event has its own visibility setting, independent of any linked entity:
- GM Only — appears only in your timeline view; hidden from the player portal
- Party — visible to all players connected to the campaign
A GM-only event linked to a party-visible NPC keeps the event hidden even though the NPC is visible. The two visibility settings are independent.
Use GM-only planned events to track plot beats you intend to happen — assassination dates, political upheavals, reinforcement arrivals. These stay invisible to players while you prep around them.
Connecting events to entities
Link any timeline event to one or more entities. When you do:
- The event appears in the Timeline section of each linked entity's page
- The entity's icon appears on the event card in the timeline view
- The knowledge graph registers the connection
This is the primary way to track NPC arcs — open an NPC and scroll to their Timeline section to see every event they're connected to, in chronological order.
The calendar system
By default, your world uses the Gregorian calendar. You can switch to a preset or build a custom calendar from World Settings → Calendar.
Presets
| Preset | Structure |
|---|---|
| Gregorian | Standard real-world calendar |
| Forgotten Realms Harptos | 12 months of 30 days plus 5 intercalary festival days |
Custom calendar builder
Define every part of your calendar:
- Weekdays — names and count (e.g., 8-day week with custom day names)
- Months — names and day counts per month
- Intercalary days — named festival or transitional days that fall between months and don't belong to a week
- Year label — the name of the dating system (e.g., "Age of Embers", "AR", "YOD")
In-world dates display as year/month/day using your calendar's names. The timeline renders event spacing based on actual day counts, so unequal month lengths affect positioning correctly.
Changing your calendar after events have been created will remap existing dates using a best-effort conversion. Set up your calendar before adding events for the most reliable results. Intercalary days added after the fact may cause minor date shifts.
Troubleshooting
My timeline events are appearing out of order. Timeline ordering is based on in-world date — year first, then month, then day. If you're using a custom calendar, confirm that month and day values fall within the ranges you defined. An event with a day value larger than your custom month's length may sort unexpectedly.
I set an event to Party visibility but players can't see it in their portal. Check that the player's campaign invite is accepted and that you're looking at the right campaign's portal. Also confirm the event is marked as Historical — planned events are hidden from players regardless of their visibility setting, since they represent future plot beats.
I built a custom calendar but dates are showing in the wrong format. The date display format follows the order Year → Month → Day using your custom names. If month names aren't appearing, check that each month has a name set (not just a day count) in the Calendar builder. Empty month names fall back to a numeric display.
An entity's Timeline section is empty even though I linked events to it. The entity Timeline section only shows events where that entity is an explicit link on the event. Open each event and confirm the entity appears in its linked entities list. If you linked the event to a different entity with a similar name, the section will be empty on the unlinked one.
See also
- Entities and articles — creating events as a full entity type
- Session Mode — surfacing timeline events during live sessions
- Key concepts — overview of how the timeline fits the world structure