---
title: "find by field exists · RUAL Documentation"
description: "Returns the matching objects of they include the given field."
canonical: https://docs.rual.nl/block-types/array/array_get_objects_by_field_exists
language: en
---

# find by field exists

This block is part of the [`array`](https://docs.rual.nl/block-types/array) group and was last modified in core [`v10.4.28`](https://docs.rual.nl/core-versions/100428).

### Field Selection Required

This block relies on a field that you select to perform its data actions. You must manually select the field you want to use in your flow using the field selector modal. To access the modal, click the white button on the block.

Returns the matching objects of they include the given field.

- array required `array` The array where the items are searched in, has to be an array with objects.

- results `array` The array of results where the given field exists.

- indexes `array` The original positions in the input array of each matched item.

KEEPS the object items on which the selected field path is present (a field explicitly set to null still counts as present), outputting them on array and their original positions on array_indexes. Items that are not objects are always dropped. With no field selected both outputs are empty.

| `where key exists` |
| --- |

A typical wiring for [find by field exists](https://docs.rual.nl/block-types/array/array_get_objects_by_field_exists): [search](https://docs.rual.nl/block-types/storage/function_search) feeds the `array` pin; the `array` out pin feeds [select field values](https://docs.rual.nl/block-types/array/array_get_values_from_bp_field).

![Studio canvas example for the find by field exists block: typical wiring for find by field exists.](https://docs.rual.nl/canvas-examples/array_get_objects_by_field_exists.png)

### Commonly used with

In production blueprints, this block is most often wired together with:

- [select field values](https://docs.rual.nl/block-types/array/array_get_values_from_bp_field): this block feeds into it. returns an array with values of the given field in this array of objects.

- [search](https://docs.rual.nl/block-types/storage/function_search): feeds into this block. searches in the given storage based on a query.

### Version history

Introduced in [`v10.4.28`](https://docs.rual.nl/core-versions/100428).