How do Reddit thumbnails work?

The other day I submitted Vidrio to /r/MacApps. After submission I found that the thumbnail for the submission defaulted to a generic image, rather than being the Vidrio icon. Why?

Reddit uses Embed.ly to retrieve a thumbnail for the submission. Embedly respects a standard called oEmbed (“open embed”?). This means, when I submitted https://vidr.io to Reddit, Reddit made a request like

curl -X GET 'https://api.embedly.com/1/oembed?format=json&url=https%3A//vidr.io&key=REDDITS_EMBEDLY_API_KEY'

and Embedly responded with some info about https://vidr.io in a JSON format defined by oEmbed. Embedly is a paid service but it offers a free HTML snippet generation service which presumably uses the same logic. Here’s the embed for Vidrio:

Vidrio for macOS

Vidrio for macOS is a holographic screencast app. Present from the future™

No thumbnail! For contrast, here’s the embed for a site which got a thumbnail on Reddit:

Speedtest by Ookla on the Mac App Store

Read reviews, compare customer ratings, see screenshots, and learn more about Speedtest by Ookla. Download Speedtest by Ookla for Mac OS X 10.10 or later and enjoy it on your Mac.

How does Embedly decide on the thumbnail for that URL? oEmbed doesn’t specify this; it only defines the formats of requests and responses. However, Embedly describes their process for choosing the image:

Embedly looks at the following attributes of the page and then ranks and scores the images.

The one to pay attention is “The Open Graph og:image property”. Embedly follows the Open Graph protocol, which “enables any web page to become a rich object in a social graph. For instance, this is used on Facebook to allow any web page to have the same functionality as any other object on Facebook.”

More concretely, Open Graph defines some meta tags, like og:image, which can be used to build an embedded representation of the page elsewhere.

So, here’s my answer: https://vidr.io didn’t get a thumbnail because the page doesn’t include an og:image. I’ll go about adding some Open Graph properties to the Vidrio site.


I wrote this because I felt like it. This post is my own, and not associated with my employer.

Jim. Public speaking. Friends. Vidrio.