---
title: "Text Picker"
slug: "text-picker"
updated: 2026-01-21T14:02:55Z
published: 2026-01-21T14:02:55Z
canonical: "docs.sightmachine.com/text-picker"
---

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

# Text Picker

The Text Picker contains a single MUI TextField for users to enter text.

[https://mui.com/material-ui/api/text-field/](https://mui.com/material-ui/api/text-field/)

### Configuration Options

The picker can be configured through the following options:

| Option | Type | Default | Description |
| --- | --- | --- | --- |
| `isRequired` | boolean | false | Specifies if the text field is required. If false, the apply button will be disabled until the user enters text. |
| `infoTooltip` | string | null | Tooltip text providing additional information. |
| `textFieldOptionOverride` | object | {} | Options to override the default MUI TextField properties. [https://mui.com/material-ui/api/text-field/](https://mui.com/material-ui/api/text-field/) |
| `value` | string | null | Optional default value if specified |

Example Configuration

```json
{
  "id": "text_picker",
  "isRequired": false,
  "infoTooltip": "Tooltip for more information",
  "textFieldOptionOverride": {
    "helperText": "This text field is for..."
  },
  "type": "text"
}
```

### Default Query Params

The text picker generates the following params to the API Query:

| Parameter | Type | Description |
| --- | --- | --- |
| `value` | string | the input text value |

Example request body:

```json
"text_picker": {
  "pickerType": "text",
  "value": "User's free form text value"
}
```

### Page Link

Example mapping for page link.

Assigning the text with any string.

```python
{
    "mapping": {
        'text': '"assigned_text"'
    }
}
```