> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.cloudraker.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.cloudraker.com/_mcp/server.

# Records in a space

A **record** is a structured row of data — an extracted invoice, a patient intake, a contract's key terms — that lives inside a [space](/spaces/overview). Every record belongs to a **record type**, which defines its fields. Records show up on a space's **Data** tab, where you can add them by hand, review the ones an action or the agent produced, and organize them with saved views.

Record types (the field definitions) are defined once at the org level and are **read-only** from the Data tab. To create or change a record type, see [Record types](/data/record-types).

## Open the Data tab

Open a space and select the **Data** tab. You'll see the heading **Record types** with the line *"Structured records collected in this space."*

The tab lists only the record types that actually have records in this space, as a table with **Name** and **Records** (a count) columns. If nothing has been collected yet, you'll see *"No records yet — Records added to this space show up here, grouped by type. Add one to get started."*

Two buttons sit in the header:

* **Add record** — pick a record type, then create a record of that type in this space.
* **Manage record types** — jump to the org-level [record type](/data/record-types) definitions (read-only from here).

<img src="https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/cloudraker.docs.buildwithfern.com/fe1b29f9042e3bf2a5afc877b95af454c6cb6e9642bcc78d0b79e58fbb59a4ad/docs/assets/images/guide/data/data-tab-landing.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260726%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260726T051139Z&X-Amz-Expires=604800&X-Amz-Signature=8c2d8efe4686fea9fdd9459bd3904c2dfc0ae96848b36da3b7c0a8bb2de89c47&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject" alt="The space Data tab listing the Invoices record type with a record count, alongside the Manage record types and Add record buttons" />

## Add a record

#### Choose a type

Click **Add record**. A picker opens — *"Add a record — Choose the type of record to add to this space."* If no types exist yet, you'll see *"No record types are defined yet. An admin can create them under Manage record types."*

#### Fill in the fields

The **New record** dialog opens with fields grouped (a **General** group plus any custom groups the type defines). Required fields are marked with `*`.

#### Create it

Click **Create record**. The record is added to this space and appears in its type's table.

You can also add the first record of a type from that type's empty table: **Add the first record**.

## The records table

Select a record type to open its records surface. A view toolbar sits on top (see [Saved views](#saved-views)), and below it the records table shows:

* The type's **title field** pinned to the left (the field configured as each record's title).
* The columns the current view makes visible.
* A per-column **review dot** on columns an action or the agent wrote, marking fields that still need review.
* A trailing **Created** column.
* **Load more** paging at the bottom.

The header carries a **New record** button. An empty table reads *"No records yet — Add the first record to get started."*

<img src="https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/cloudraker.docs.buildwithfern.com/cd0e25833f58231a6b7574f61698d3d05b8873d8feed9770f6009b76b299ab94/docs/assets/images/guide/data/records-table.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260726%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260726T051139Z&X-Amz-Expires=604800&X-Amz-Signature=ae8ff7a0f6693bb7df9bb38460e1019842c31418b2c3333c0887da5881c4d71f&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject" alt="The Invoice records table with the Invoice number title column pinned to the left, the view toolbar above it, and a New record button" />

## Open a record

Click a row to open the record as a full-page, two-pane workspace.

* **Records with AI-written fields** show the **cited source document** on the left and the fields on the right. Selecting a field's citation reveals it in context — a bounding-box highlight on the PDF page, or a seek into the audio transcript. (If you haven't selected a citation yet: *"Select a field's cited source to preview it here."*)
* **Records you created by hand** show the fields full-width, with no source pane.

The header shows the created and updated dates and, when the record came from automation, provenance links: **Created by action run** and **From playbook run**. Follow them to the [action run](/actions/run-an-action) or playbook run that produced the record.

<img src="https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/cloudraker.docs.buildwithfern.com/f89dbf19add737880685b513b97c83c19b534f2478880f9dbc6b2ed172c3cf7d/docs/assets/images/guide/data/record-two-pane.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260726%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260726T051139Z&X-Amz-Expires=604800&X-Amz-Signature=a19e388b5635465f43270830d741d90eb62ea0f410e46fec734ecbeb4b464261&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject" alt="A record open as a two-pane workspace: the cited source invoice with a highlighted invoice number on the left, and the fields with their citation and review chips on the right" />

### Edit a field

Click a field to edit it inline, then **Save** (or **Cancel**). Optional fields also offer **Clear** to empty them.

### Locked fields

A locked field shows a lock icon (*"This field is locked"*). A lock **pins the field so an automated run won't overwrite it** — useful when you've corrected a value by hand and don't want the next extraction to clobber it. You don't have to unlock it first: when you edit a locked field, the app **auto-unlocks it as part of the same save**.

## Review and provenance

Fields an action or the agent wrote carry their **source citations** and a per-field **review control**, so you can check each value against where it came from. A citation chip on the field links back to the cited passage.

* **Approve all on this record** — approve every AI-written field on the open record in one click. (This button only appears on records that have AI-written fields.)
* **Column-level bulk review** — from a column's header, choose **Review this column across N records**, then **Approve this column**, **Reject this column**, or **Dismiss this column**. This clears the review backlog for one field across every record at once.

Review status renders as a dot or badge on the cells.

Editing an AI-written value replaces it with your text and **removes its source citation** — the same trade-off as editing in an extraction run's review workspace.

## Saved views

A **view** is a saved arrangement of columns, filters, and sorts over one record type. Use the view toolbar to switch and manage them.

* **Default View** always exists and **can't be renamed or deleted**.
* **Create custom view** — starts from the current view's columns, filters, and sorts, which you can then change. (*"The new view starts from the current view's columns, filters, and sorts."*)
* The toolbar also offers **Copy link to view** and **Delete view**.

#### Fields — choose the columns

The **Fields** panel toggles and reorders a view's columns: *"Toggle and drag to reorder the columns of this view."* It splits into visible fields and **Hidden fields (N)**.

#### Filter — show only matching records

The **Filter** panel shows only records matching your conditions. Combine conditions with **All conditions (AND)** or **Any condition (OR)**. Available operands: **Is, Is not, Is empty, Is not empty, Contains, Does not contain, Greater than, Greater than or equal, Less than, Less than or equal, Is before, Is after, Is any of, Includes any of.**

#### Sort — order the records

The **Sort** panel orders records by one or more fields, each **Ascending** or **Descending**. The default is newest-first.

Editing a view's columns, filters, or sorts requires permission. Without it, the panels are read-only.

## Where records come from

Most records aren't typed in by hand — they're **imported from an [extraction action](/actions/extract-data)**. When an extraction is configured to output a record type, approving its results imports them into this Data tab as records, complete with citations and provenance. See [Extract data](/actions/extract-data) for that flow.