Mastodon Timeline Embed

Mastodon Timeline Embed

Drop-in timeline widget pages

written by
Unknown: an image by Unknown

Mastodon Timeline Embed

Embeddable Mastodon timelines (profile/hashtag/local) using a client-side widget.

MAINTAINED webapp Updated January 4, 2026
Mastodon Timeline Embed hero image

What it does

This is a small collection of static embed pages that render a Mastodon timeline inside a container using the MastodonTimeline JavaScript widget.

It’s useful when you want an embeddable feed UI (e.g., profile posts) without running a server.

How to use it

  • Open: /tools/mastodon/index.html

There are multiple entry pages under /tools/mastodon/ for different feed types:

  • Profile timeline: /tools/mastodon/profile.html
  • Hashtag timeline: /tools/mastodon/hashtag.html
  • Local timeline: /tools/mastodon/local.html

To point the embed at a different instance / account / hashtag, edit the page’s inline initialization block (it passes settings like instanceUrl, timelineType, and userId).

Notes

  • The widget fetches public data via the instance’s API endpoints.
  • Because this is client-side, the browser is the one making requests to the Mastodon instance.

Details

Tech
  • JavaScript
  • HTML
  • CSS
License
AGPL-3.0-only
Tags
mastodon social embed timeline javascript tools

Features

  • Profile / hashtag / local timeline modes
  • Light/dark theme (auto via prefers-color-scheme)
  • Pure client-side embed (fetches from Mastodon API)

Screenshots