Change over time
Time-series chart with event annotations
Adds dated events or shaded periods to explain the context around a time series.
- Chart
- Trend over time
- Event context
What it answers
What happened around a notable event?
- Shape
- Line with labelled markers or regions
- What it shows
- Temporal coincidence and before/after context.
Example
The question
How did weekly sign-ups respond to the campaign and the price change?
Weekly sign-ups with events marked
Illustrative data. It belongs to no company.
When to use it
Use it when
Adding launches, outages or policy changes as context.
Avoid it when
When annotations overwhelm the data or imply unsupported causal claims.
How to read it
Read the trend and locate dated annotations without assuming causation.
Note
Coincidence with an event does not establish causation.
The data you need
- Layout
- Two linked tables
- Fields
- Time: date; Value: number; separate EventTime and EventLabel records
- One row is
- One time-series observation; each event record describes a separate annotation. What is the grain?
- Rules
- Keep measured observations separate from annotation records. Use the same time zone.
- Optional
- EventEnd for shaded intervals. Do not copy an event onto every observation.
- Preparation
- Parse and sort timestamps or sequence positions; aggregate duplicates deliberately and preserve gaps. Keep measured observations separate from annotation records. Use the same time zone.
- Units
- Time uses a stated date/time unit and sampling period; the value axis uses the measure's unit. Rates need their own explicit denominator.
Worked example
Jan 1=30, Feb 1=34; launch Jan 15. Mark the launch. The later value is 4 higher; the chart cannot attribute that rise to launch.
| Series: Time | Value |
|---|---|
| 2026-01-01 | 30 |
| 2026-02-01 | 34 |
| Events: EventTime | EventLabel |
| 2026-01-15 | Launch |
