Using TimelineJS

TimelineJS is an open-source tool that enables anyone to build visually rich, interactive timelines. Beginners can create a timeline using nothing more than a Google spreadsheet. Experts can use their JSON skills to create custom installations while keeping TimelineJS's core functionality.

Tips & tricks

  1. Keep it short. We recommend not having more than 20 slides for a reader to click through.
  2. Pick stories that have a strong chronological narrative. It does not work well for stories that need to jump around in the timeline.
  3. Write each event as a part of a larger narrative.
  4. Include events that build up to major occurrences — not just the major events.

Learn more

Get up and running in minutes. Learn how to:

Getting stuck?

Technical documentation

Go further with Timeline:

Need help?

First, please be sure to look at our list of frequently asked questions.

If you don't find an answer there, we offer tech support via email or a web form. We try to be prompt, but please understand that we do not have a dedicated tech support staff.

Find a bug?

If you are confident you have found a bug, please report it as a GitHub issue. Be sure to include detailed instructions on how to reproduce the bug. If you're not sure, please start with the tech support system.