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

# PLURALIZE

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

Outputs the singular or plural version of text based on the value of a number.

**Categories:** Text

## Syntax

```
PLURALIZE(counter, text, [plural_text])
```

## Examples

### Example 1

Input:

```json
{
  "my_action": {
    "message": 2
  }
}
```

Formula:

```
PLURALIZE(my_action.message, "item")
```

Output:

```json
"items"
```

### Example 2

Input:

```json
{
  "my_action": {
    "message": 1
  }
}
```

Formula:

```
PLURALIZE(my_action.message, "item")
```

Output:

```json
"item"
```

### Example 3: For custom pluralization, you can pass a third argument:

Input:

```json
{
  "my_action": {
    "message": 5
  }
}
```

Formula:

```
PLURALIZE(my_action.message, "bonus",  "bonuses")
```

Output:

```json
"bonuses"
```

## Sample actions

### Sample action 1

```json
{
  "standardLibVersion": "14",
  "actionRuntimeVersion": "3",
  "agents": [
    {
      "disabled": false,
      "name": "My Action",
      "description": "",
      "options": {
        "mode": "message_only",
        "loop": false,
        "payload": {
          "message": 2
        }
      },
      "position": {
        "x": 1830,
        "y": 3840
      },
      "type": "eventTransformation",
      "timeSavedUnit": "minutes",
      "timeSavedValue": 0,
      "monitorAllEvents": false,
      "monitorFailures": false,
      "monitorNoEventsEmitted": null,
      "form": null
    },
    {
      "disabled": false,
      "name": "PLURALIZE",
      "description": "",
      "options": {
        "mode": "message_only",
        "loop": false,
        "payload": {
          "pluralize": "=PLURALIZE(my_action.message, \"item\")"
        }
      },
      "position": {
        "x": 1830,
        "y": 3945
      },
      "type": "eventTransformation",
      "timeSavedUnit": "minutes",
      "timeSavedValue": 0,
      "monitorAllEvents": false,
      "monitorFailures": false,
      "monitorNoEventsEmitted": null,
      "form": null
    }
  ],
  "links": [
    {
      "sourceIdentifier": 0,
      "receiverIdentifier": 1
    }
  ],
  "diagramNotes": []
}
```

### Sample action 2

```json
{
  "standardLibVersion": "14",
  "actionRuntimeVersion": "3",
  "agents": [
    {
      "disabled": false,
      "name": "My Action",
      "description": "",
      "options": {
        "mode": "message_only",
        "loop": false,
        "payload": {
          "message": 1
        }
      },
      "position": {
        "x": 2010,
        "y": 3840
      },
      "type": "eventTransformation",
      "timeSavedUnit": "minutes",
      "timeSavedValue": 0,
      "monitorAllEvents": false,
      "monitorFailures": false,
      "monitorNoEventsEmitted": null,
      "form": null
    },
    {
      "disabled": false,
      "name": "PLURALIZE",
      "description": "",
      "options": {
        "mode": "message_only",
        "loop": false,
        "payload": {
          "pluralize": "=PLURALIZE(my_action.message, \"item\")"
        }
      },
      "position": {
        "x": 2010,
        "y": 3945
      },
      "type": "eventTransformation",
      "timeSavedUnit": "minutes",
      "timeSavedValue": 0,
      "monitorAllEvents": false,
      "monitorFailures": false,
      "monitorNoEventsEmitted": null,
      "form": null
    }
  ],
  "links": [
    {
      "sourceIdentifier": 0,
      "receiverIdentifier": 1
    }
  ],
  "diagramNotes": []
}
```

### Sample action 3

```json
{
  "standardLibVersion": "14",
  "actionRuntimeVersion": "3",
  "agents": [
    {
      "disabled": false,
      "name": "My Action",
      "description": "",
      "options": {
        "mode": "message_only",
        "loop": false,
        "payload": {
          "message": 5
        }
      },
      "position": {
        "x": 2190,
        "y": 3840
      },
      "type": "eventTransformation",
      "timeSavedUnit": "minutes",
      "timeSavedValue": 0,
      "monitorAllEvents": false,
      "monitorFailures": false,
      "monitorNoEventsEmitted": null,
      "form": null
    },
    {
      "disabled": false,
      "name": "PLURALIZE",
      "description": "",
      "options": {
        "mode": "message_only",
        "loop": false,
        "payload": {
          "pluralize": "=PLURALIZE(my_action.message, \"bonus\", \"bonuses\")"
        }
      },
      "position": {
        "x": 2190,
        "y": 3945
      },
      "type": "eventTransformation",
      "timeSavedUnit": "minutes",
      "timeSavedValue": 0,
      "monitorAllEvents": false,
      "monitorFailures": false,
      "monitorNoEventsEmitted": null,
      "form": null
    }
  ],
  "links": [
    {
      "sourceIdentifier": 0,
      "receiverIdentifier": 1
    }
  ],
  "diagramNotes": []
}
```