---
title: "Summary"
description: "a count, share, rank or ratio in one of three positions, never folded"
section: concepts
address: /concepts/summary
contract: 0476e35e6e275db5
---

# Summary

a count, share, rank or ratio in one of three positions, never folded

[figure: Summary is a fact at follows scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | fact |
| scope | follows |
| key | the predicate, its own definition and the window |
| store | postgres |
| family | rules_engine |



## Fields


| field | type | required | note |
|---|---|---|---|
| `position` | `one of measured \| never measured \| withheld` | yes |  |
| `value` | `json` | no | only for measured, which may be zero |
| `reason` | `text` | no | for never measured |
| `withheld_count` | `count` | no |  |
| `coverage` | [ChannelCoverage](/concepts/channelcoverage) | yes |  |
| `population` | [PopulationStatement](/concepts/populationstatement) | yes |  |
| `predicate_version` | `hash` | yes |  |
| `definition_version` | `count` | yes |  |



## Routes that use it
No route takes or returns Summary directly. The record holds it, and the objects that point at it reach it.