# TimelineJS

JavaScript storytelling timeline that presents dated slides and media in a web page.


Source: https://findsoftware.frbit.cloud/timelinejs/
Last reviewed: 2026-11-16
Listed since: 2026-11-16

## Record

### Links

- home: https://timeline.knightlab.com
- repository: https://github.com/NUKnightLab/TimelineJS3
- docs: https://timeline.knightlab.com/docs/
- x: https://www.twitter.com/knightlab
- facebook: https://www.facebook.com/knightlab

### Identity

- status: active
- maintainer: Northwestern University Knight Lab
- maintainerType: unknown
- parent: unknown
- firstRelease: 2015
- hqCountry: unknown

### Kind

- category: ui-library
- hosting: not applicable
- language: javascript
- runtime: unknown
- runtimeMin: not applicable
- basedOn: unknown

### Content

- contentStore: not applicable
- databases: not applicable
- adminUi: not applicable
- headlessApi: not applicable
- templating: not applicable
- i18n: yes, translation sets selected with a language code

### Rendering and deploy

- runsAs: browser
- renderingModes: not applicable
- installMethod: cdn, download

### License

- licenseModel: open-source
- license: MPL-2.0

### Releases

- currentMajor: 3
- latestReleaseDate: 2026-07-26

### Adoption

- githubStargazers: 3236
- packagistDownloads: not applicable
- npmWeeklyDownloads: 5684
- contributors: 45
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 12
- dependentPackages: 4

### Sources

- urls: https://timeline.knightlab.com/ (read 2026-11-16)
- urls: https://api.github.com/repos/NUKnightLab/TimelineJS3 (read 2026-11-16)
- urls: https://timeline.knightlab.com/docs/ (read 2026-11-16)
- category: https://timeline.knightlab.com/docs/ (read 2026-11-16)
- firstRelease: https://api.github.com/repos/NUKnightLab/TimelineJS3/git/ref/tags/3.0.0 (read 2026-11-16)
- maintainer: https://timeline.knightlab.com/ (read 2026-11-16)
- language: https://api.github.com/repos/NUKnightLab/TimelineJS3 (read 2026-11-16)
- license: https://github.com/NUKnightLab/TimelineJS3/blob/master/LICENSE (read 2026-11-16)
- licenseModel: https://github.com/NUKnightLab/TimelineJS3/blob/master/LICENSE (read 2026-11-16)
- runsAs: https://timeline.knightlab.com/docs/instantiate-a-timeline.html (read 2026-11-16)
- installMethod: https://timeline.knightlab.com/docs/instantiate-a-timeline.html (read 2026-11-16)
- installMethod: https://timeline.knightlab.com/docs/instantiate-a-timeline.html (read 2026-11-16)
- npmWeeklyDownloads: https://api.npmjs.org/downloads/range/2026-11-01:2026-11-07/@knight-lab/timelinejs (read 2026-11-16)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/@knight-lab%2Ftimelinejs (read 2026-11-16)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/@knight-lab%2Ftimelinejs (read 2026-11-16)
- githubStargazers: https://api.github.com/repos/NUKnightLab/TimelineJS3 (read 2026-11-16)
- contributors: https://api.github.com/repos/NUKnightLab/TimelineJS3/contributors?per_page=1 (read 2026-11-16)
- currentMajor: https://registry.npmjs.org/@knight-lab/timelinejs (read 2026-11-16)
- latestReleaseDate: https://registry.npmjs.org/@knight-lab/timelinejs (read 2026-11-16)
- i18n: https://timeline.knightlab.com/docs/options.html (read 2026-11-16)

## Notes

TimelineJS is a JavaScript library that presents dated slides, with text and media, as a timeline in a web page. A page loads the stylesheet and the script, then creates a timeline in an element; the slide data comes from a JSON object or from a Google Spreadsheet. The docs also describe an authoring tool for people who do not write code, which produces the markup for the embed.

## Worth knowing

The authoring tool and the hosting on Knight Lab's systems are a hosted service next to the open-source library. A timeline that reads its slides from a Google Spreadsheet depends on that spreadsheet staying in place.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0
