Skip to content

Why Ask Folio shows its sources first.

An answer you cannot check is a rumour. How we designed Ask Folio around the lines it read, and why it sometimes says it couldn’t find anything.

LEdited by LeaNov 4, 20266 min read

On November 2 we shipped a small change with a long history: every answer from Ask Folio now links to the exact blocks it read. Hover a number and the source line lights up. This post explains why we spent a year on something that looks like a footnote.

An answer is a claim

When a colleague tells you the vacation policy, you weigh it: do they know, did it change, are they guessing? A machine that answers in the same confident tone every time removes that signal. So we decided early that Ask Folio would not ask for trust. It would show its work, and make checking it faster than reading the page.

If you cannot check an answer in under five seconds, you will either ignore it or believe it. Both are bad.
From the Ask Folio design doc, March 2025

Citations down to the block

The first version cited pages. That was not enough: the Benefits page is 2,000 words long, and knowing the answer is “somewhere in Benefits” does not save time. Citing blocks meant keeping track of which blocks went into each answer, through retrieval, ranking and generation, and throwing an answer away if it made a claim we could not attach to a block.

  1. Retrieve candidate blocks, filtered by the asker’s permissions first, never after.
  2. Rank them, preferring verified pages and newer edits.
  3. Write the answer with each sentence tied to the blocks that support it.
  4. Drop any sentence that is not tied to a block. If nothing is left, say so.

Permissions come first. A block you cannot open never reaches the model. The answer cannot leak what it never saw.

What the numbers say

MeasurePages citedBlocks cited
Median time to an answer1.4 s1.2 s
Answers people opened a source for11%38%
Answers marked wrong4.1%1.6%
Answers citing a verified page81%94%
Two weeks of answers across 2,300 workspaces that opted in to measurement, before and after Nov 2.

The surprise was the second row. When the source is one line away, people check. When they check, they catch the rare wrong answer, mark it, and the owner of the page fixes the page. Citations turned out to be a maintenance tool as much as a trust tool.

The answer we are proudest of

It is this one: I couldn’t find a page you can open that answers this. It is the least impressive answer Folio gives and the most important. It tells you the gap is real, and it tells the workspace owner what to write next. Business workspaces get a weekly list of questions Folio could not answer.

Ask Folio is part of Folio AI, $8 per member per month on any paid plan, and Free workspaces get 20 answers to try. See how it works.

L

Written by

Lea Moreau

Lead, Ask Folio, Montreal. Owns the page “How answers are made”.

All posts

Keep reading

More from the blog.

Every post
  • Engineering9 min

    Fifty thousand rows in under a second.

    How we made databases open four times faster without a rewrite: a smaller first paint, a smarter query plan and one very boring cache.

    HHana Sato

  • Inside Folio5 min

    How we write specs at Folio.

    One page, four headings, and a section called “Not doing” that saves more time than the rest combined. Our spec template, with the reasons behind it.

    JJonas Brandt

  • Writing4 min

    Meeting notes that turn into work.

    Most meeting notes are a transcript nobody opens again. Three small habits turn them into decisions, owners and dates that land in the right table.

    MMarta Silva

Write it down once. Find it forever.

Folio is free for personal use. Teams pay per member who edits, and guests are always free.