Writing Link Annotations Readers Actually Click
When I looked at click data for 40 issues of my weekly roundup, one pattern was hard to miss. Links with a two sentence note got roughly three times the clicks of links with only a headline.

When I looked at click data for 40 issues of my weekly roundup, one pattern was hard to miss. Links with a two sentence note got roughly three times the clicks of links with only a headline. Links with a long paragraph did worse than the two sentence ones. The difference was not which article I picked. It was how I wrote the link annotations.
An annotation is the short note a curator writes beside each link, explaining why it deserves a reader's time. It is the only part of a curated list that is truly yours, since the articles belong to someone else. Here is how I write link annotations that readers trust and act on, with templates, mistakes and the habits that keep it from eating my whole evening.
Why Link Annotations Carry a Curated List
A list of bare links is a bookmark folder. Readers can get headlines from any feed reader. What they cannot get elsewhere is your judgement: why this piece, why now, and what they will get out of it.
A good annotation does three jobs in about 30 to 60 words:
- Sorts. It tells readers whether the link is for them, so the wrong people skip it guilt free.
- Sets expectations. Length, format, paywall, depth. Nobody likes clicking into a 9,000 word essay expecting a quick read.
- Adds a point of view. One sentence of what you think, agree with or question.
The Two Sentence Structure That Works
After a lot of drafts, I settled on a simple pattern. Sentence one says what the piece actually shows or argues, with something specific. Sentence two says who should read it or what to watch for.
A city librarian tracked which of her 212 RSS subscriptions she opened over a year and cut the rest. Worth reading if your reader has crossed 100 feeds, skip the last third, which is mostly tool recommendations.
That note tells you the subject, the evidence, the audience and a reading tip. Compare it to "Great piece on managing feeds, highly recommend." The second version tells you nothing the headline did not.
Three openers I rotate
- The finding: lead with the most surprising number or claim in the piece.
- The question: name the problem the piece answers, then say whether it answers it well.
- The contrast: say what this piece gets right that most coverage of the topic gets wrong.
Common Annotation Mistakes
Most weak annotations fall into a handful of patterns. I have made every one of them.
- Restating the headline. If your note could be generated from the title alone, cut it.
- Empty praise. "Fascinating," "must read" and "so good" carry no information. Readers learn to ignore them fast.
- Spoiling the whole piece. Summarizing every point removes the reason to click. Give the setup and one detail, not the conclusion.
- Hidden caveats. If a piece is paywalled, sponsored or a podcast, say so up front. Trust drops the first time a reader feels tricked.
- Inside jokes. References only regulars will understand push new subscribers away.
Why "Keep It Short" Is Only Half Right
The standard advice is to keep annotations as short as possible. I push back on this. Short is not the goal; dense is. A twelve word note that says "Interesting take on newsletters from a longtime writer" is short and useless. A 55 word note that names the argument, flags the weak section and says who benefits is long and valuable.
The real rule is that every sentence must change the reader's decision to click or skip. When my notes ran past 80 words, readers seemed to treat the annotation as the content and moved on. Somewhere between 25 and 60 words is where my lists perform best, but I would rather publish a 70 word note with a real insight than a 20 word one without.
The exception is the lead item. Many curators give the first link a full paragraph of commentary, and that works, because it signals what the issue is about and gives readers a reason to keep scrolling.
Writing Annotations Fast Without Losing Quality
Annotations used to take me three hours a week. The fix was capturing notes while reading, not afterwards. When I star an article in my feed reader, I add one line to the star note right away: the detail that made me save it. By the end of the week, I edit those raw lines instead of rereading 25 articles from scratch. I describe the starring side of this in how I turn RSS stars into a weekly link roundup.
A few other habits save time:
- Write all annotations in one sitting so the voice stays consistent.
- Read each note aloud. If it sounds like a press release, rewrite it.
- Keep a short swipe file of your own best notes to reread before a batch.
Labels and Signals Readers Scan For
Readers skim before they read. Small, consistent markers help them find their items in seconds. I add a bracketed tag at the end of a note when it applies.
| Tag | Meaning | Why it helps |
|---|---|---|
| [12 min] | Estimated reading time | Readers pick short items for a coffee break |
| [paywall] | Subscription required | Prevents the frustrated click |
| [audio] | Podcast or talk | Saves it for the commute |
| [old but good] | Published over a year ago | Explains why it is not news |
Keep the set small. Four or five tags, used every issue, beat twelve tags used inconsistently.
Annotations Age Better Than Links
A curated archive has a quiet problem. Links break, articles move and paywalls go up. When that happens, the annotation is often the only record left of what the piece said and why you chose it. A note like "argued that RSS readers should default to oldest first, citing a 2019 survey of 800 users" keeps value even after the link dies. "Great read!" does not. If you keep an archive, it is worth reading our guide to preventing link rot in a curated archive alongside this.
FAQ
Should I quote the article in my annotation?
A short quote of one line can work when the author's phrasing is the point. Keep it brief, mark it clearly as a quote, and still add your own sentence so the note is not just borrowed words.
Is it fine to include links I disagree with?
Yes, and readers often value them most. Say plainly that you disagree and why, in one sentence. That honesty makes your positive notes more believable.
How many links should a curated list include?
For a weekly list, 7 to 12 well annotated links usually beat 25 thin ones. If you cannot write a specific note for an item, that is a sign it should not make the cut.
The Practical Takeaway
For your next issue, rewrite every annotation using two sentences: one specific thing the piece shows, one note on who should read it or what to watch for. Cut any word of praise that carries no information, add a reading time tag, and compare clicks against your last three issues. You can find more on building lists people return to in our curation section.
More in Curation
Curation
A Tagging System for Saved Articles That Survives a Year
I exported my read-later library last spring to check something unrelated and found 1,847 saved articles carrying 240 distinct...
Curation
How to Handle Paywalled Links in a Curated Reading List
The complaint that finally changed how I do this arrived in March, from a reader who had followed my weekly links for about two...
Curation
How to Share an OPML Bundle People Will Actually Import
Someone asked me in September for my feeds on soil science and small presses.