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

# Linked record field

> Search, select, create, and edit linked records directly from a form.

## What this does

The linked record field maps to Airtable's Linked Records (Multiple Record Links) field type. It lets respondents search existing records in the linked table, select them, and optionally create or edit linked records without leaving the main form.

## Settings reference

### Record preview

| Setting                 | Description                                                                                                         |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Display style**       | Choose how selected linked records are shown after selection: **List** or **Table**.                                |
| **Fields to display**   | Choose which linked-table fields appear in the record preview. The primary field is always shown.                   |
| **Disable field names** | Hide the preview field labels in list view and show only the values. Only available when Display style is **List**. |

### Record selection

| Setting                       | Description                                                                                                                                                                                 |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Disable searching records** | Turn off the record picker search. Use this when respondents should not browse existing Airtable records and should only work with records created during the form flow or prefilled links. |
| **Always filter by**          | Permanent filters applied to which linked records appear as options. Records that don't match won't appear in the search results.                                                           |

### Editing linked records

| Setting                      | Description                                                                                                                      |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| **Enable editing**           | Allow respondents to edit existing linked records through a child form.                                                          |
| **Form to open for editing** | The child form that opens when a respondent clicks to edit a linked record. Opens a full form editor scoped to the linked table. |

### Creating linked records

| Setting                                               | Description                                                                                                                                                            |
| ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Enable creating**                                   | Allow respondents to create new linked records through a child form.                                                                                                   |
| **Form to open for creating**                         | The child form that opens when a respondent clicks to create a new record.                                                                                             |
| **Only show records created in this form submission** | The record picker only shows records created during the current session. Useful for multi-step forms where one field creates records that another field then links to. |

### Count limits

| Setting               | Description                                                                                     |
| --------------------- | ----------------------------------------------------------------------------------------------- |
| **Minimum records**   | Minimum number of linked records required.                                                      |
| **Maximum records**   | Maximum number of linked records allowed.                                                       |
| **Min error message** | Custom error shown when too few records are linked. Use `{min}` as a placeholder for the count. |
| **Max error message** | Custom error shown when the maximum is reached. Use `{max}` as a placeholder.                   |

**Universal settings that also apply:** Label, description, required, show/hide rules, conditional read-only.

## Read-only behavior

When a linked record field is **read-only** (either via the static toggle or conditional read-only), the field switches into a display-only mode:

* The remove (X) button is hidden on each linked record, so respondents cannot unlink records.
* The **Create record** button is hidden, even if **Enable creating** is on.
* Clicking a linked record no longer opens the edit child form, even if **Enable editing** is on.
* Count limits (minimum/maximum) are not enforced because the respondent cannot change the selection.

Because searching, creating, editing, and count-limit settings have no effect when the field is read-only, they are disabled in the field settings panel with an inline warning. Flip the field back to editable to adjust those options.

## Child forms

When editing or creating linked records is enabled, Filla opens a child form, a full embedded form editor scoped to the linked table. Child forms:

* Support all the same field types and widgets as the main form
* Have their own page structure
* Open in a modal overlay within the main form

This lets respondents manage related records without leaving the main form flow. For example, on an order form, a respondent could add a new product record to a Products table and immediately link it to the order.

When you first open a create or edit child form and no child form has been configured yet, Filla starts you with a minimal child form automatically. The linked table's primary field is added for you as the first field so you are never starting from a blank child form.

See [Child forms](/docs/linked-records/child-forms) for the full guide.

## Record preview styles

### List

List mode shows each selected record as a compact card:

* the primary field as the title
* any chosen preview fields as labeled metadata rows
* attachment fields as visual previews where possible
* URL-like values rendered as clickable links

This is the best choice when you want a more visual, respondent-friendly summary of each linked record.

### Table

Table mode shows selected records in a denser grid-style layout. This is useful when respondents need to compare several linked records side by side, especially when you include multiple preview fields.

## Common questions

<AccordionGroup>
  <Accordion title="How does the record search work?">
    The respondent types into the linked record field and Filla searches the linked table for matching records. The primary field of the linked table is used for matching by default.
  </Accordion>

  <Accordion title="Can I filter which records appear based on form answers?">
    Yes, using the **Always filter by** setting with dynamic filter conditions. For example, you could show only records where a Status field matches a value the respondent selected earlier. See [Filtering records](/docs/linked-records/filtering-records).
  </Accordion>

  <Accordion title="What's the difference between minimum and required?">
    **Required** means at least one record must be linked. **Minimum records** lets you require a specific count, for example requiring at least 2 linked records.
  </Accordion>

  <Accordion title="Can I show more than the primary field after a record is selected?">
    Yes. Use **Fields to display** in the linked record field settings to choose which extra fields appear in the selected-record preview. The primary field is always shown.
  </Accordion>
</AccordionGroup>
