Feed Viewer logo Feed ViewerRead the web on your terms
Curation

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.

Curated reading list with short handwritten notes beside each saved link

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.

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.

  1. Restating the headline. If your note could be generated from the title alone, cut it.
  2. Empty praise. "Fascinating," "must read" and "so good" carry no information. Readers learn to ignore them fast.
  3. Spoiling the whole piece. Summarizing every point removes the reason to click. Give the setup and one detail, not the conclusion.
  4. Hidden caveats. If a piece is paywalled, sponsored or a podcast, say so up front. Trust drops the first time a reader feels tricked.
  5. 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.

TagMeaningWhy it helps
[12 min]Estimated reading timeReaders pick short items for a coffee break
[paywall]Subscription requiredPrevents the frustrated click
[audio]Podcast or talkSaves it for the commute
[old but good]Published over a year agoExplains why it is not news

Keep the set small. Four or five tags, used every issue, beat twelve tags used inconsistently.

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.

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.

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.

LF
Leocadia Fennimore

Leocadia has used RSS since the days of Google Reader and never stopped. She edits the site's feed and reader coverage and keeps around four hundred subscriptions under control.

More posts by Leocadia

More in Curation

01doorganico 084goad 3hot8 4465456 after5internprogram ahandfulofblessings ahmadpc ahomcybersecurity allodialresources annodex antiquesandperiodcollectibles aotc asianworldkashmir beedlectrics bloggertemplatefree bluefeatheragency bodyweightsolution campaign08blog carfixadvisor catstreetcollective cbstvsports cnfanspurchasing committeeof500yearsofdignityandresistance covertopsdjs cs-kaiyuangame cuestacomunicaciontotal cxoutlet dancebetgame deskgearhub destinyvillastay detectmagazine di33 diamondsteelbuildings donmo dyanadropship emarsysfinance emimattl escapechan eskitarih evautoplay everythingweddings-orlando farmzone foxstudiosscratch gamevui123 gleasongrade greetingsday hacklabasu haskell iw-kaiyun jagoanproperti jilidskripsi joltbusinessfinance juegodepokergratis juegospucca kaeru-festival latestmehndidesigns lestanzediottaviano litemagazines localcommunityhero lustrsazan mariashebets menswheels newwebstechs1 nikkit ootheday oxigenvpn plurfitness prefetial probudgetcarpetcleaning psychicmrsmartin pyaten qvantor rejoignezlogis rexzbot riselayouts ruchin rwxqsgd5 sakaltime shibiaowang shop-bot skrtips spotlesshaven strcoding tetapatrium topselller uneplanteartificielle vipertechcr webtech1223411 wo-kygaming yamaha-mekar yeknava yoybuysheets zenunwa yamaha-mekar jilidskripsi ankertoto ankertoto ankertoto