# tmuxp.cli.search.normalize_fields

- **Module:** tmuxp.cli.search
- **Package:** tmuxp
- **Language:** Python
- **Kind:** function
- **Source:** https://github.com/tmux-python/tmuxp/blob/153acdf6ff1268b14d3d03ed488f545a7123c8f1/src/tmuxp/cli/search.py#L144
- **Page:** https://libtmux.org/en/py/latest/workspace/reference/tmuxp-cli-search-normalize_fields/

```
tmuxp.cli.search.normalize_fields(fields: list[str] | None) -> tuple[str, ...]
```

Normalize field names using aliases.

## Parameters

- `fields` (list[str] | None): Field names or aliases to normalize. If None, returns DEFAULT_FIELDS.

## Returns

tuple[str, ...]
    Tuple of canonical field names.

## Raises

- `InvalidFieldError`: If a field name is not recognized.

## Example

```python
>>> normalize_fields(None)
('name', 'session_name', 'path', 'window', 'pane')
```

## Example

```python
>>> normalize_fields(["s", "n"])
('session_name', 'name')
```

## Example

```python
>>> normalize_fields(["session_name", "path"])
('session_name', 'path')
```

## Example

```python
>>> normalize_fields(["invalid"])  # doctest: +ELLIPSIS
Traceback (most recent call last):
    ...
tmuxp.cli.search.InvalidFieldError: Unknown search field: 'invalid'. ...
```