> ## Documentation Index
> Fetch the complete documentation index at: https://help.edzo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Timeline Block

> Learn how to use Timeline blocks to display events along a horizontal timeline.

The **Timeline** block displays events along a horizontal timeline with configurable range, intervals, and event descriptions. Use it to teach chronology, historical events, and sequencing concepts.

## When to use Timeline blocks

Timeline blocks work well for:

* Displaying historical events in chronological order
* Teaching sequencing and chronology concepts
* Showing the relationship between events over time
* Illustrating timespans and eras in history and social studies
* Creating visual references for any subject that involves dates or sequences

## Settings

### Timeline settings

<ParamField path="Start" default="1770" type="input">
  The starting value of the timeline (typically a year).
</ParamField>

<ParamField path="End" default="1830" type="input">
  The ending value of the timeline.
</ParamField>

<ParamField path="Interval" default="10" type="input">
  The spacing between major tick marks on the timeline.
</ParamField>

### Events

Add events to the timeline, each with:

* **Date**: The position on the timeline where the event appears
* **Label**: A short title for the event
* **Description**: A longer explanation of the event (optional)
* **Image**: An image to accompany the event (optional)
* **Color**: A custom color for the event marker (optional)

You can add up to 100 events on a single timeline.

### Display settings

<ParamField path="Show labels" default="true" type="switch">
  When enabled, displays event labels on the timeline.
</ParamField>

## Tips for teachers and parents

**Best practices:**

* Use meaningful intervals that match the time period (decades for centuries, years for shorter spans)
* Keep event labels short and descriptive
* Use descriptions for additional context that doesn't fit in the label
* Add images to make events more engaging and memorable
* Color-code events by category (e.g., political events in red, cultural events in blue)
* Start with a small number of events and add more as the topic develops
* Great for HASS (Humanities and Social Sciences), history, and science timelines

## Related blocks

* [Number Line](/creating/resources/learning-blocks/number-line): For numeric sequences without event labels
