---
title: "is empty · RUAL Documentation"
description: "checks if the value is empty"
canonical: https://docs.rual.nl/block-types/condition/condition_empty_value
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 value is empty

- Value required `value` The value to be checked.

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

True only when the value pin resolves to nil/missing or the exact empty string ""; everything else yields false, including 0, false, whitespace-only strings, and empty arrays or objects.

A typical wiring for [is empty](https://docs.rual.nl/block-types/condition/condition_empty_value): [custom field](https://docs.rual.nl/block-types/object/object_get_custom_field) feeds the `value` pin; the `condition` out pin feeds [OR](https://docs.rual.nl/block-types/condition/condition_or).

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

### Commonly used with

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

- [OR](https://docs.rual.nl/block-types/condition/condition_or): this block feeds into it. operator for a set of operands is true if and only if one or more of its operands is true.

- [get fields](https://docs.rual.nl/block-types/object/object_field_getter_multiple): feeds into this block. Gets the selected fields from the given object.

- [if](https://docs.rual.nl/block-types/mutations/mutations_branch): this block feeds into it. use mutations X or Y based on a condition.

- [custom field](https://docs.rual.nl/block-types/object/object_get_custom_field): feeds into this block. get the value of a custom field with a custom value block, or dynamic value.

- [substring](https://docs.rual.nl/block-types/value/value_substr): feeds into this block.

### Version history

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