> ## 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.

# Record picker

> How the linked record picker works for respondents and how to configure it.

## What the record picker does

The record picker is the default interface for linked record fields. Respondents type a search query and see a list of matching records from the linked Airtable table. They click a record to select it and link it to the current submission.

## How search works

The picker searches the primary field of the linked table as the respondent types. Results update with each keystroke. The respondent can select one or more records depending on whether the Airtable field allows multiple links.

Selected records appear as tags below the search input. The respondent can remove a selected record by clicking the X on its tag.

After selection, records can also be shown in either **List** or **Table** display style, with extra preview fields if you configure them on the linked record field. In **List** mode you can also turn on **Disable field names** to hide the field labels in the preview and show only the values — useful when the field meaning is already obvious from context and the labels feel noisy.

If you turn on **Hide record search** in the linked record field settings, the search input is removed entirely. This is useful when respondents should only link records created during the current form flow or records you have already prefilled.

## Filtering which records appear

You can restrict which records appear in the picker using the **Always filter by** setting on the linked record field. This is a permanent filter. Records that don't match the filter never appear as options.

**Example:** On an order form, you might have a "Products" linked field. If you only want to show active products, add a filter: `Status` `is` `Active`.

See [Filtering records](/docs/linked-records/filtering-records) for detailed configuration.

## Creating new records from the picker

If **Enable creating** is turned on, a "Create new" button appears in the picker. The respondent clicks it and a child form opens where they can fill in details for a new record. That new record is automatically linked to the current submission.

The first time you open the child form editor, Filla automatically creates a starter child form with the linked table's primary field already added. You can then expand it with more fields, pages, and validation as needed.

See [Child forms](/docs/linked-records/child-forms) for how to set this up.

## Count limits

You can require a minimum number of linked records, enforce a maximum, or both. The picker shows an error if the respondent tries to submit with too few or too many records selected.

See [Count limits](/docs/linked-records/count-limits) for configuration details.

## Read-only mode

If the linked record field is set to read-only (either statically or via conditional read-only), the picker becomes a display of the currently linked records only. The search input, create button, edit action, and remove (X) buttons are all hidden. Count limits are not enforced because respondents cannot change the selection.

## Common questions

<AccordionGroup>
  <Accordion title="What field does the picker search against?">
    The primary field of the linked table. This is the first field in the table, the one shown in bold in Airtable's grid view. You control which field is primary in Airtable.
  </Accordion>

  <Accordion title="How many records can the picker load?">
    The picker loads records in pages as the respondent types. It does not load all records upfront. Search queries are sent to Airtable in real time.
  </Accordion>

  <Accordion title="Can I restrict to single-record selection?">
    The single vs multiple selection behavior is controlled by the Airtable field type. If the Airtable field is a single-record link field, the picker only allows one selection.
  </Accordion>

  <Accordion title="Can I show additional fields from the linked record after selection?">
    Yes. Use the linked record field's **Fields to display** setting to show extra fields in the selected-record preview. This applies to both list and table display styles.
  </Accordion>
</AccordionGroup>
