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

Weekly sign-ups with events markedSign-ups run near 215 a week, jump to 410 after the campaign starts in week 6, and drop back to about 235 after the price rise in week 11.Sign-ups per week0150300450W1W3W5W7W9W11W13W15Campaign startsPrice +10%
Weekly sign-ups with events markedSign-ups run near 215 a week, jump to 410 after the campaign starts in week 6, and drop back to about 235 after the price rise in week 11.Sign-ups per week0150300450W1W5W9W13CampaignPrice +10%
Sign-ups run near 215 a week, jump to 410 after the campaign starts in week 6, and drop back to about 235 after the price rise in week 11.

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.
Example of the input layout: Two linked tablesTwo linked tables, joined by a shared key column.KeyValueABCKeyDetailABC
Two linked tables, joined by a shared key column.

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: TimeValue
2026-01-0130
2026-02-0134
Events: EventTimeEventLabel
2026-01-15Launch