---
title: "Grounding"
description: "the grounding of one subject, a captured page, an entity, a text or an address: its mentions resolved and its relations suggested as hypotheses a person settles; staged when the subject is given, waiting for a person once the hypotheses are made, committed when every one is settled; the same work on every face"
section: concepts
address: /concepts/grounding
contract: 0476e35e6e275db5
---

# Grounding

the grounding of one subject, a captured page, an entity, a text or an address: its mentions resolved and its relations suggested as hypotheses a person settles; staged when the subject is given, waiting for a person once the hypotheses are made, committed when every one is settled; the same work on every face

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

| property | value |
|---|---|
| kind | work |
| scope | follows |
| key | the subject and the breadth |
| store | postgres |
| family | sources |



## Fields


| field | type | required | note |
|---|---|---|---|
| `subject` | `one of a capture \| an entity \| a text \| an address` | yes | what was grounded |
| `capture` | `hash` | no | the artefact's hash, for a capture or an address the record holds a capture of |
| `text` | `text` | no | the text grounded, cut to 4,000 characters, for a text |
| `address` | `text` | yes | the page's address, the entity's own page, or empty for a text |
| `platform` | `text` | yes |  |
| `breadth` | `one of exact \| similar \| related \| broad` | yes |  |
| `entity` | `id` | no | the entity the page became |
| `hypotheses` | `[id]` | yes |  |
| `mentions` | `[id]` | yes |  |
| `channels` | `[text]` | yes | the channels that ran: exact keys, names, meaning, thread, neighbourhood |
| `candidates` | `count` | yes |  |
| `made_at` | `time` | yes |  |
| `settled_at` | `time` | no |  |
| `settled_by` | [Caller](/concepts/caller) | no |  |



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