---
title: IS_EMPTY
url: https://www.tines.com/docs/formulas/functions/is-empty/
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)*

# IS_EMPTY

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

Returns true if a value is empty ie. `""`, `[]`, `{}` and false otherwise. Target value must be text, array, or an object. See also [`IS_BLANK`](https://www.tines.com/docs/formulas/functions/is-blank).

**Categories:** Text, Objects, Arrays

## Syntax

```
IS_EMPTY(text | array | object)
```

## Examples

### Example 1

Input:

```json
{
  "my_action": {
    "value1": ""
  }
}
```

Formula:

```
IS_EMPTY(my_action.value1)
```

Output:

```json
{
  "value1": true
}
```

### Example 2

Input:

```json
{
  "my_action": {
    "value2": []
  }
}
```

Formula:

```
IS_EMPTY(my_action.value2)
```

Output:

```json
{
  "value2": true
}
```

### Example 3

Input:

```json
{
  "my_action": {
    "value3": {}
  }
}
```

Formula:

```
IS_EMPTY(my_action.value3)
```

Output:

```json
{
  "value3": true
}
```

### Example 4

Input:

```json
{
  "my_action": {
    "value4": "Hello World"
  }
}
```

Formula:

```
IS_EMPTY(my_action.value4)
```

Output:

```json
{
  "value4": false
}
```

## Sample actions

```json
{
  "standardLibVersion": "13",
  "actionRuntimeVersion": "1",
  "agents": [
    {
      "disabled": false,
      "name": "My Action",
      "description": "",
      "options": {
        "mode": "message_only",
        "loop": false,
        "payload": {
          "value1": "",
          "value2": [],
          "value3": {},
          "value4": "Hello World"
        }
      },
      "position": {
        "x": 420,
        "y": 2205
      },
      "type": "eventTransformation",
      "timeSavedUnit": "minutes",
      "timeSavedValue": 0,
      "monitorAllEvents": false,
      "monitorFailures": false,
      "monitorNoEventsEmitted": null,
      "form": null
    },
    {
      "disabled": false,
      "name": "IS_EMPTY",
      "description": "",
      "options": {
        "mode": "message_only",
        "loop": false,
        "payload": {
          "value1": "=IS_EMPTY(my_action.value1)",
          "value2": "=IS_EMPTY(my_action.value2)",
          "value3": "=IS_EMPTY(my_action.value3)",
          "value4": "=IS_EMPTY(my_action.value4)"
        }
      },
      "position": {
        "x": 420,
        "y": 2295
      },
      "type": "eventTransformation",
      "timeSavedUnit": "minutes",
      "timeSavedValue": 0,
      "monitorAllEvents": false,
      "monitorFailures": false,
      "monitorNoEventsEmitted": null,
      "form": null
    }
  ],
  "links": [
    {
      "sourceIdentifier": 0,
      "receiverIdentifier": 1
    }
  ],
  "diagramNotes": []
}
```