I read Gumroad's source code. Discover ranks products by the fees Gumroad earns, not by your sales.

faheemsayeed — Thu, 01 Oct 2026 05:36:17 +0000

Gumroad open-sourced its code, so I stopped guessing how its marketplace (Discover) works and read it. I do technical SEO for a living, and I wanted the same thing I want from any search engine: the actual ranking signals, not folklore.

Below are 8 things the code says. Every one links to the exact lines, pinned to a commit from 30 September 2026 so the links don't drift. The code changes often, so check the current version before you bet a launch on any of it.

1. "Trending" sorts by the fees Gumroad earned from your product

The default Discover sort is not sales count and not revenue. It is total_fee_cents, the fee Gumroad earned from your product over the last 3 months, with sales volume only as a tie-breaker.

Source: searchable.rb, sort block

A direct sale costs you 12.9% + $0.80. That fixed $0.80 means cheap products climb faster per dollar:

$100 of sales at...	Fee Gumroad earns (= rank score)
$1 each (100 sales)	$92.90
$10 each (10 sales)	$20.90
$49 each (≈2 sales)	$14.53

Same revenue, 4.4x the rank for the $1 product versus the $10 one. Best Sellers uses the same idea over 12 months (past_year_fee_cents).

2. Above $4.68, a Discover sale lifts your rank more than a direct sale

A sale that comes through Discover pays a flat 30%. A direct sale pays 12.9% + $0.80. The two are equal at $4.68. Above that price, each Discover sale adds more to your rank score than a sale you brought in yourself; below it, your own traffic counts for more.

It also means every sale you drive from your own audience feeds your Discover rank. External traffic and Discover are not separate games.

3. There is a hard gate, and most "no views" products never pass it

A product only appears in Discover if all of these are true (product/recommendations.rb):

published and not archived
ratings displayed (turn off "Display your product's 1-5 star rating" and you disappear)
not sold out
a category is set
at least one sale that counts toward volume

And the seller needs (user/recommendations.rb): a name, a payout method, and a "compliant" risk state. That last one is set by a person at Gumroad, and the help center says the review happens after roughly $10 in genuine sales.

So "Gumroad has zero organic discovery" is often literally true for a new store: with zero sales, none of your products are eligible. Uploading 20 more products doesn't change that. One real sale on one product does.

4. A ~50-word keyword list can hide you

Gumroad runs an adult-keyword detector over product text and over your name, username and bio (adult_keyword_detector.rb). It splits CamelCase, so a word hiding inside a longer token still counts. In product text, a match blocks the save. Innocent listings hit this: lingerie photo presets, "uncensored" prompts, a boudoir Lightroom pack.

5. Search is literal: every word must match, and plurals don't

Discover search runs simple_query_string with default_operator: and over four fields: name, creator name, description and tags (searchable.rb). The standard analyzer does no stemming.

In practice: if a buyer types "notion templates" and your listing only says "template", you are not in the results. Every word they type has to appear somewhere in those four fields. Write the plural and singular forms of your main noun into the description.

6. Logged-out searchers see the fee sort, not relevance

When someone searches while not signed in, results are ordered by the same fee-based Trending sort, not by how well the text matches. I checked this live with a search for "seo". Relevance ordering (_score) is only used for the curated sort that signed-in users with purchase history get.

So for most first-time visitors, matching the query gets you in, and sales get you up.

7. "Hot & New" is a 90-day window, and the bar is low

Hot & New is limited to products created in the last 90 days (searchable.rb) and sorted by sales volume. I pulled the top 9 across a set of popular tags: 73% had one rating or fewer. In a tag like "claude", 28.2% of listed products were under 90 days old; in "notion template", 0.8%. Newer niches are where a new seller can actually be seen.

8. Tags: 10 per product, and hyphens break filtering

You can add 10 tags (2–20 characters each), and the Discover sidebar shows the top 9 for any result set. One bug worth knowing: the tag filter converts hyphens in the URL to spaces (search_products.rb), so a tag saved as self-improvement can't be selected as a filter; you get self improvement, a different tag. I'm reporting it to Gumroad. Until it's fixed, use spaces in tags, not hyphens.

Bonus: Gumroad is building Google landing pages from category + tag

A PR merged on 26 September adds curated SEO descriptions to category + tag pages. The PR mentions one such page drawing 132,355 Google impressions in 7 days. Pick tags that match real category pages and you may get Google traffic from Gumroad's pages, not only from Discover.

What I'd do with a new product

Set a category, keep ratings visible, add a payout method.
Put every word a buyer would type (including plurals) into the title, description or tags.
Get one genuine sale from anywhere: a friend who actually wants it, a forum reply, a newsletter.
Price above $4.68 if you want Discover sales to lift you.
Launch into a tag where Hot & New isn't crowded.

I turned the eligibility gate and the keyword list into a free offline checker (one HTML file, runs in your browser, nothing uploaded): Discover Eligibility Checker. The full write-up with every rule and line reference is a paid guide on my profile, but everything in this post stands on its own.

Not affiliated with Gumroad. All of this comes from their public repo; if they change the code, the rules change.

DEV Community: faheemsayeed