> ## Documentation Index
> Fetch the complete documentation index at: https://docs.custral.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Checklist

> A checklist of records. Check an item to complete it, writing a real field.

## Overview

Checklist renders records as a scannable, read-only list with one interactive control per row: a completion circle. Checking an item writes a **real field** on the record (a Status/Select option, or a Checkbox field set to on), so the completed state shows everywhere that record appears, not just in this list. Completed items dim, strike through, and drop to the bottom.

## Use cases

Onboarding steps, follow-up lists, review queues. Anywhere a person works through records and marks each done, and you want "done" to be real data (it drives reporting, filters, and automation) rather than a per-list flag.

## Configuration

Open the block's **Display** popover:

| Setting       | What it does                                                                                                |
| ------------- | ----------------------------------------------------------------------------------------------------------- |
| Object        | The object whose records appear (required).                                                                 |
| Complete when | The field that marks an item done: a **Status**, **Select**, or **Checkbox** property (required).           |
| Done value    | For a Status/Select field, the option that means "done". Hidden for a Checkbox field, where done = checked. |

Filtering and sorting use the block's filter bar, exactly like a Table.

## How completing works

* **Checkbox field**: checking sets it to on; unchecking sets it to off.
* **Status / Select field**: checking sets the field to your chosen **Done value**; unchecking clears it.

Because it writes a real field, the value appears on the record everywhere, and any workflow watching that field fires as usual.

## Troubleshooting

| Symptom                                                  | Cause / fix                                                                                                              |
| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| "Choose a status, select, or checkbox field…" message    | No **Complete when** field is set. Open Display and pick one.                                                            |
| Checking an item does nothing or reverts                 | The field couldn't be written. Confirm you have edit access, and that a **Done value** is set for a Status/Select field. |
| The **Checkbox** field type isn't in the property picker | The property schema re-seeds on API boot; a self-hosted API needs a restart to pick it up.                               |
| The list is empty                                        | A filter (possibly on the completion field) excludes every record. Clear or widen it in the filter bar.                  |

## See also

* [List](/blocks/embedded/databases/list): a read-only list with no completion control.
* [Checkbox property](/data/properties/common/checkbox): the on/off field the checklist can complete.
* [Table](/blocks/embedded/databases/table)


## Related topics

- [Change Log](/product/updates.md)
- [Checkbox](/data/properties/common/checkbox.md)
- [Embedded Components](/blocks/embedded/overview.md)
- [Implementation](/start/use/implementation.md)
- [Task Overview](/team/tasks/overview.md)