Guides / Reality gap

What is a reality gap?

4 min readCites 1 record

Fig. 4. Promised against observed. The distance is the finding.

In brief

A reality gap is the measurable distance between what a company promises and what its users report. It needs a falsifiable promise on one side (a number, a window, a guarantee) and dated public testimony on the other. Timeline discrepancy is its cleanest instance: promised in days, lived in weeks, witnessed in public.

The definition, formally#

Four conditions make a reality gap, and each one earns its place by excluding something.

A falsifiable promise. “World-class support” can never have a gap; it commits to nothing. “Refunds take 3 to 5 business days” can, because a day-count can be wrong.

Reported experience, in public. The other side is testimony: dated, linkable accounts from people who took the promise up on it. Internal metrics stay internal; the gap is built from what the public record shows.

Measurability. Promise and reports must share a unit: days against days, dollars against dollars, clicks against clicks. Without the shared unit you have a complaint. With it, a measurement.

Persistence. One bad week is noise. A gap exists when the distance survives across months of testimony, and it acquires a direction: holding, widening, closing. The trend is part of the object.

The anatomy, on a record#

Here is the definition running on a live instance. PayPal’s help page promises refunds “up to 5 business days.” The same paragraph concedes that card refunds “may take up to 30 days.” We fed the headline promise through the pipeline on 9 July 2026; 50 admissible reports came back. The finding: refunds take 2 to 10 days, often longer.

Every element of the definition is visible in that figure. The falsifiable promise (a day-count, from PayPal’s own page). The public reports (50 of them, each linked on the record). The shared unit (days). And the persistence: the record labels the pattern stable, meaning this distance has held its shape across the testimony’s whole date range. A stable gap is the most telling kind. Weather moves; this distance holds still, and the friction guide takes up whose interest that stillness serves.

From the public record

“PayPal refunds take 3-5 business days”

50 reports · 8 platforms · strong evidence · stable · signed 22d5 8342 e286 1b58

The cleanest instance#

Timeline discrepancy is the reality gap at its purest, for one reason: time resists spin. A company can argue about what “premium quality” means. Nobody argues about what day 19 means. When the promise is a duration and a hundred people post their day-counts, the gap computes itself, and re-checks can track it moving. That is why the timeline line sits in the middle of every record that has one, and why the friction guide can go further and ask whose interest the slippage consistently serves.

The other “reality gap”#

Roboticists coined the same phrase decades ago for a sibling problem: a robot trained in simulation fails on the physical floor, because the simulator was a flattering model of the world. Same deep structure. A polished model on one side, reality on the other, and failure exactly proportional to the distance. A marketing page is a simulator too: it renders a product with the friction turned off. The record is the physical floor. If you came here for the sim-to-real sense, that literature is yours; this page defines the consumer sense, and the two rhyme on purpose.

The objection#

Definition elements grounded in the PayPal record (50 reports, 8 platforms, author-signed) and PayPal’s own help page, fetched 2026-07-09. Robotics sense per the sim-to-real literature. Every number links in place.