---
title: "includes · RUAL Documentation"
description: "Checks if the find string is included in the value string."
canonical: https://docs.rual.nl/block-types/condition/condition_includes_string
language: en
---

# includes

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 `find` string is included in the `value` string.

- Value required `value` The string in which inclusion will be checked.

- Find required `value` The string to find within the main value.

- Boolean `condition` Returns true if the `find` string is found within the `value` string, otherwise false. Also false when either string is empty, so an empty `find` is not treated as trivially included.

True when find occurs as a case-sensitive substring of value. False when find is absent AND ALSO when either value or find is empty or missing - an empty find is not treated as trivially included. Example: value="Abc" find="abc" -> false (case-sensitive).

A typical wiring for [includes](https://docs.rual.nl/block-types/condition/condition_includes_string): the `condition` out pin feeds [branch](https://docs.rual.nl/block-types/flow/branch).

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

### Version history

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