---
alias: "fc.field.multistring"
aliases:
  - fc.field.multistring
category: field
module: Core
---
# fc.field.multistring

Multi-value string input that converts free-text entries into individual chips. Supports context search (partial match) and exact search (strict match) modes, with automatic duplicate removal.

## When to Use
- Filter forms requiring multiple search terms (e.g., multi-ref search, multi-SKU lookup)
- Any input where users need to enter several string values as tags/chips
- Bulk search interfaces for order refs, product refs, or tracking numbers

## Key Props
| Prop | Type | Required | What it controls |
|------|------|----------|------------------|
| `exactSearch` | boolean | No | When `true`, enforces exact case-sensitive matching. Default: `false` (context/partial search). |
| `visibleItemsThreshold` | number | No | Minimum chips shown before excess collapses into dropdown. Default: `2` |

## Data Binding
The component outputs an array of string values. Each entered value becomes a chip. Duplicates are automatically removed. Leading/trailing spaces are trimmed. Empty strings are ignored.

## Descendants
No.

## Gotchas
- Two search modes: Context Search (default, partial matching) and Exact Search (set `exactSearch: true`, strict case-sensitive matching).
- Duplicate entries are silently removed -- the component ensures unique values only.
- Empty strings and whitespace-only entries are rejected.
- Clear removes all chips; Cancel restores initial values; Apply finalizes selection.

## Manifest Example
```json
{
  "component": "fc.field.multistring",
  "props": {
    "exactSearch": false,
    "visibleItemsThreshold": 3
  }
}
```

## AI Parse Notes
- **Primary intent:** Declarative Mystique component definition for manifests.
- **Selection signals:** Match by `alias`, category, and required `Key Props`.
- **Assembly hints:** Combine with compatible parent/child components listed in `Composition Patterns`.
- **Safety checks:** Validate required props and data bindings before manifest generation.
