---
title: "SampleUnit"
description: "one unit of a preview's sample, with the words that met the predicate"
section: concepts
address: /concepts/sampleunit
contract: 0476e35e6e275db5
---

# SampleUnit

one unit of a preview's sample, with the words that met the predicate

[figure: SampleUnit is a value at none scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | value |
| scope | none |
| key | none |
| store | none |
| family | rules_engine |



## Fields


| field | type | required | note |
|---|---|---|---|
| `unit` | `id` | yes |  |
| `kind` | `text` | yes |  |
| `name` | `text` | no |  |
| `stratum` | `text` | yes | the values of the population's strata, joined |
| `matched_by` | [Highlight](/concepts/highlight) | yes | the words of the unit that met each text condition |



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