> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://documentation.celestory.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 🟦 List includes

# 🟦 List includes

${frame}[Video: anatomy of the List includes block](https://celestory-docs-videos.netlify.app/en/anatomie-bloc/includes.html)

![List includes](https://celestory-docs-illustrations.netlify.app/en/Listincludes_EN.svg)

The List contains block allows you to check if a specific element (text, number or boolean) is present in a given list.

This block is particularly useful for conditional checks, such as the presence of an object in an inventory or a value in a data collection.

## 📥 Entries

- list (List of Values): The list in which to search for the element.
- value (Text, Number or Boolean): The element to search for in the list (its type depends on the content of the list).

## 📤 Outings

- value (Boolean): Returns True if the element is present in the list, False otherwise. This output can be connected to a conditional block (If/Else) to trigger actions accordingly.

## 💡 Example of use

Scenario: Checking an item in the player's inventory

1. The player has an Items list containing ["Key", "Potion", "Sword"].
1. The game must check if the player has the Key to open a door.
1. The List contains block is configured with list = Objects and value = "Key".
1. The value output returns True, indicating that the Key is indeed in the inventory.
1. A Condition block uses this result to authorize the opening of the door.

## ⚙️ Technical Details

- Behavior: This block does not modify the flow of the scenario but evaluates a condition. It has no stream input or output (in/out), only data input/output.
- Type management: The type of the value entry automatically adapts to the content of the list (eg: Text for a list of strings, Number for a list of numeric values).

---

*Documented version: v1*