---
title: "includes - multi search · RUAL Documentation"
description: "checks if one of the given strings is included in the primary string."
canonical: https://docs.rual.nl/block-types/value/value_includes_multi_search
language: en
---

# includes - multi search

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

checks if one of the given strings is included in the primary string.

- value required `value`

- searches required `array` strings to search

- has match `condition`

- matches `array`

Case-SENSITIVE substring test: matches lists each entry of searches found anywhere in value (the terms themselves, not positions); has_match is true when at least one hit exists. Nil entries are skipped, non-string entries are coerced JS-style, and an empty-string entry matches EVERYTHING. A non-array searches yields has_match false and empty matches.

| `has value` |
| --- |

A typical wiring for [includes - multi search](https://docs.rual.nl/block-types/value/value_includes_multi_search): [value](https://docs.rual.nl/block-types/value/value_default) feeds the `value` pin; [with values](https://docs.rual.nl/block-types/array/array_of_values) feeds the `searches` pin; the `has_match` out pin feeds [branch](https://docs.rual.nl/block-types/flow/branch).

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

### Version history

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