# $listItems->findBy()

> Find a single element by an attribute and its value

- Source: `src/Toolkit/Collection.php#L393` <https://github.com/getkirby/kirby/blob/6.0.0-beta.1/src/Toolkit/Collection.php#L393>
- Inherited from Kirby, not part of the Merx API. See <https://getkirby.com/docs/reference>.

```php
$listItems->findBy(string $attribute, $value): TValue|null
```

## Parameters

| Name | Type | Default |
| --- | --- | --- |
| `$attribute` | `string` | `–` |
| `$value` | `–` | `–` |

## Return type

`TValue|null`

## Parent class

`Wagnerwagner\Merx\ListItems` inherited from `Kirby\Toolkit\Collection`