Reddit — butter docs Skip to content
Widgets / Read

Reddit

Posts from any subreddit, sorted how you read it. Subreddit-validated up front so you never end up staring at a 404.

Point the widget at a subreddit and pick a sort — Hot, Top, New, or Rising. Each row is a post with title, score, comment count, timestamp, and (optionally) a thumbnail. Click the title for the linked content; click the comment count for the thread.

Free 8×4 default 5-minute cache
Reddit
  • What replaced your old Notion second brain?
    r/webdev · 612 ↑
  • Why I went back to plain text and a folder
    r/programming · 410 ↑
  • Best new tab replacements in 2026
    r/chrome · 318 ↑

Add it to your dashboard

Press E , then A , pick Reddit. Open settings on the new widget and type a subreddit name. Defaults are sane: r/programming, sorted by Hot, NSFW filtered, thumbnails on.

The widget pulls Reddit's public JSON endpoint — no account, no OAuth, no API key. A response cache lives in your browser for five minutes per subreddit + sort combination, so flipping between two widgets doesn't burn through requests.

How the subreddit field works

  • Input is lenient. Paste r/programming, /r/programming, or programming/ — all three land on the same canonical programming.
  • Validation is strict. Reddit's own naming rule is 3–21 letters, digits, or underscores. The widget refuses anything else with an inline message rather than letting you save a name that'll 404 silently.
  • Two widgets, two subs. Drop two Reddit widgets to read r/programming and r/woodworking side by side. Independent caches, independent settings.

Settings

Setting Type Default
Subreddit

Type a subreddit name (without the r/) and tab away or press Enter to commit. Pasted r/ prefixes and trailing slashes are stripped automatically. Validated against Reddit's 3–21 alphanumeric+underscore rule so you can't end up with a 404 widget.

subreddit name programming
Sort

Reddit's four standard sorts. Top reveals an extra Top from dropdown for the time window (Past hour through All time).

Hot · Top · New · Rising Hot
Posts to show

How many posts to fetch and render, between 3 and 30. Set high if you scroll, low if you skim.

integer 10
Top from

Only relevant when Sort is set to Top. Picks the time window for "top" — past day is the usual choice; all-time is great for first-time visitors.

hour · day · week · month · year · all day
Minimum upvotes

Drops anything below the threshold server-side. Zero means no filter. Helpful on busy subs where you only want the posts that have already cleared the noise floor.

integer 0
Hide NSFW posts

On by default — NSFW-flagged posts are filtered out before they reach the widget. Toggle off if you're willing.

toggle on
Show thumbnails

When a post has a thumbnail, the widget shows it on the left of the row. Toggle off for a text-only list — denser, faster to scan.

toggle on

Small things you might miss

  • Thumbnails fall back gracefully. If a post has no thumbnail, the row simply doesn't include the image slot — the title takes the full width. Mixed feeds (some images, some not) look fine.
  • Top sort exposes its time window. Pick Sort = Top and a new dropdown appears below it. The widget only shows the dropdown when it applies, so the settings panel stays uncluttered.
  • Score is the post karma at fetch time. Reddit returns the live number; the widget displays it as-is. Cached responses can be up to five minutes behind reality.

Heads up

  • Private / quarantined subs won't work. The widget uses Reddit's anonymous JSON endpoint, so any subreddit that requires a login to view returns an empty list. There's no way to attach a Reddit account in this widget.
  • Rate limits are subreddit-wide, not per user. Reddit rate-limits the anonymous endpoint by source. If you have many widgets open across many devices on the same network, you might occasionally see an error — wait a minute and the next refresh will recover.
  • NSFW filter is honest. When the toggle is on, the widget drops posts Reddit has flagged NSFW. It does not look at the content; it trusts the flag.