---
title: INCLUDES
url: https://www.tines.com/docs/formulas/functions/includes/
kind: formula-function
---

*[tines.com](https://www.tines.com/llms.txt) › [Docs](https://www.tines.com/llms.txt) › [Formulas](https://www.tines.com/llm/docs/formulas.md) › [Functions](https://www.tines.com/llm/docs/formulas/functions.md)*

# INCLUDES

*[View on tines.com](https://www.tines.com/docs/formulas/functions/includes/)*

Returns `TRUE` if target (which can be text, an object or an array) includes value, otherwise returns `FALSE`. See examples for what "includes" means for different types.

**Categories:** Text, Objects, Arrays

## Syntax

```
INCLUDES(target, value)
```

## Examples

### Example 1: If the target is text, returns true if the value is a segment of the text.

Formula:

```
INCLUDES("Hello World", "World")
```

Output:

```json
true
```

### Example 2: Is case-sensitive. Use DOWNCASE() or UPCASE() to make it case-insensitive.

Formula:

```
INCLUDES("Hello World", "world")
```

Output:

```json
false
```

### Example 3: If the target is an array, returns true if the value exactly matches an item in the array.

Formula:

```
INCLUDES(["apple", "banana", "pear"], "banana")
```

Output:

```json
true
```

### Example 4: If the target is an array, returns false if the value does not exactly match an item in the array.

Formula:

```
INCLUDES(["apple", "banana", "pear"], "pea")
```

Output:

```json
false
```

### Example 5: Arrays don't need to contain text.

Formula:

```
INCLUDES([1, 2, 3], 3)
```

Output:

```json
true
```

### Example 6: If the target is an object, returns true if the value exactly matches a key in the object.

Formula:

```
INCLUDES({"name": "Eoin", "age": 30}, "age")
```

Output:

```json
true
```

## Sample actions

```json
{
  "standardLibVersion": "13",
  "actionRuntimeVersion": "1",
  "agents": [
    {
      "disabled": false,
      "name": "INCLUDES",
      "description": "Includes checks if a string, array, or an object contain a specific value (in this case fruit).",
      "options": {
        "mode": "message_only",
        "loop": false,
        "payload": {
          "includes": "=INCLUDES(my_action.string, 'Apples')",
          "includes_array": "=INCLUDES(my_action.array, 'bananas')",
          "includes_object": "=INCLUDES(my_action.object, 'fruit')"
        }
      },
      "position": {
        "x": -6570,
        "y": -1125
      },
      "type": "eventTransformation",
      "timeSavedUnit": "minutes",
      "timeSavedValue": 0,
      "monitorAllEvents": false,
      "monitorFailures": false,
      "monitorNoEventsEmitted": null,
      "form": null
    },
    {
      "disabled": false,
      "name": "My Action",
      "description": null,
      "options": {
        "mode": "message_only",
        "loop": false,
        "payload": {
          "string": "Apples are the best fruit",
          "array": [
            "apples",
            "bananas",
            "grapes"
          ],
          "object": {
            "fruit": "apple"
          }
        }
      },
      "position": {
        "x": -6570,
        "y": -1215
      },
      "type": "eventTransformation",
      "timeSavedUnit": "minutes",
      "timeSavedValue": 0,
      "monitorAllEvents": false,
      "monitorFailures": false,
      "monitorNoEventsEmitted": null,
      "form": null
    }
  ],
  "links": [
    {
      "sourceIdentifier": 1,
      "receiverIdentifier": 0
    }
  ],
  "diagramNotes": []
}
```