---
url: "https://vueda.dev/v3/reference/api/vue/FieldPickerMenuList.md"
title: "FieldPickerMenuList"
---

# FieldPickerMenuList

## Overview

The list step shared by the sort and filter add-menus: an eyebrow, a scrollable
list of pickable fields, and an empty state. Picking a row emits `pick` with the
field value; the host decides what happens next (the sort menu appends the field,
the filter menu drills into that field's form). Centralizes the field-row styling
so the two menus cannot drift.

Theme entry: [FieldPickerMenuList](/v3/reference/theming/keys/FieldPickerMenuList.md)

## Props

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| <span id="prop-iconOverride">iconOverride</span> | `Object` |  | `null` | A partial icon registry (`{ [componentName]: { [iconName]: { component, props } } }`) merged with inherited and default icon entries; scopes icon overrides to this component and its descendants. |
| <span id="prop-themeOverride">themeOverride</span> | `Object` |  | `null` | A partial ThemeObject keyed by component name, merged over this component's theme and provided to descendants. |
| <span id="prop-items">items</span> | `array` |  | `[]` | Pickable options: `{ value, label }`. |
| <span id="prop-eyebrow">eyebrow</span> | `string` |  | `""` | Eyebrow heading above the list. |
| <span id="prop-emptyText">emptyText</span> | `string` |  | `""` | Message shown when there are no pickable fields left. |
| <span id="prop-itemIcon">itemIcon</span> | `string` |  | `null` | Optional trailing icon-registry key per row (e.g. `"chevronRight"` to signal a drill-in). |
| <span id="prop-qa">qa</span> | `string` |  | `"field-picker"` | `data-qa` base; rows get `${qa}-item`, the empty state gets `${qa}-empty`. |

## Events

| Name | Description |
| --- | --- |
| `pick` | Emitted with the picked field value when a row is clicked. |

[Full event reference](/v3/reference/api/vue/FieldPickerMenuList/events.md)

## Source

`client/lib/display/field-picker/FieldPickerMenuList.vue`