---
title: "is empty · RUAL Documentation"
description: "checks if the array is empty"
canonical: https://docs.rual.nl/block-types/condition/condition_empty_array
language: en
---

# is empty

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

checks if the array is empty

- Array required `array` The array to be checked.

- condition `condition` The condition that tells if the given array is empty or not.

True when the array pin is nil/missing, not an array, or an array with zero elements; false when it holds at least one element. Element values are irrelevant: an array containing only nulls is NOT empty.

A typical wiring for [is empty](https://docs.rual.nl/block-types/condition/condition_empty_array): [find by key - value](https://docs.rual.nl/block-types/array/array_get_objects_by_field_value) feeds the `array` pin; the `condition` out pin feeds [branch](https://docs.rual.nl/block-types/flow/branch).

![Studio canvas example for the is empty block: typical wiring for is empty.](https://docs.rual.nl/canvas-examples/condition_empty_array.png)

### Commonly used with

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

- [branch](https://docs.rual.nl/block-types/flow/branch): this block feeds into it.

- [find by key - value](https://docs.rual.nl/block-types/array/array_get_objects_by_field_value): feeds into this block. Returns the matching objects for the given key value pair.

- [cast to array](https://docs.rual.nl/block-types/type%20casting/file_convert_to_array): feeds into this block. Converts your given file to an array.

### Version history

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