Docs / Features / @Mentions & oEmbed

@Mentions & oEmbed

Threadline comments support @mentions to tag other users and automatic rich embeds for popular media links.

@Mentions

Type @username in a comment to mention another Threadline user. Handles are derived from display names (e.g. "John Doe" → @john_doe). Mentioned users receive an in-app notification and optional email.

Hey @john_doe, great point about the article!

• Autocomplete appears as you type @
• Mentions render as highlighted profile links
• Self-mentions do not trigger notifications
• Mentions in held-for-review comments notify only after approval (pending)

oEmbed previews

Paste a supported URL in a comment and Threadline renders a rich preview below the text. Previews lazy-load when scrolled into view.

• YouTube — video player
• Twitter / X — embedded tweet
• GitHub Gist — code embed
• CodeSandbox — live sandbox iframe
• Vimeo — video player
• Spotify — audio player

If oEmbed resolution fails, the URL falls back to a plain link. Only trusted providers are allowed. Responses are cached for 24 hours.

API

GET /v1/oembed?url=https://www.youtube.com/watch?v=...
GET /v1/users/mentions/search?q=john

# Website proxy (dashboard / same-origin)
GET /api/oembed?url=...

Provider examples

Paste any of these URL shapes into a comment (or call GET /v1/oembed?url=...) to resolve a rich preview:

• YouTube - https://www.youtube.com/watch?v=dQw4w9WgXcQ and short form https://youtu.be/dQw4w9WgXcQ
• Twitter / X - https://x.com/jack/status/20
• GitHub Gist - https://gist.github.com/user/gistid
• CodeSandbox - https://codesandbox.io/s/example
• Vimeo - https://vimeo.com/148751763
• Spotify - https://open.spotify.com/track/...
• Fallback - any other URL gets an OG/meta link card when possible

Example response shape for GET /v1/oembed?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ:

{
  "provider": "youtube",
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "html": "<iframe src=\"https://www.youtube.com/embed/dQw4w9WgXcQ\" ...></iframe>",
  "title": "Rick Astley - Never Gonna Give You Up",
  "type": "video",
  "thumbnail_url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg"
}