---
title: "Action test_list"
description: "Generates a test list of 7 items for checking lists in a scenario."
---

# Action `test_list`

> **System ID:** `action_test_list`

## Description

Utility action for development and tests: builds a list of 7 items (`test 1` … `test 7`). Optionally filters by text and can set `value` on an exact match. For production, `generate_list` is usually used instead.

## Events (scenario branches)

No fixed branch events: the action returns a **list object** (`total`, `value`, `list`), not a scenario branch name.

## Parameters

No parameters in the node JSON (`{}`).

Optional call argument (if passed from list context):

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `text` | string | no | `null` | Substring filter (case-insensitive); an exact match with an item's `text` sets `value` |

## Configuration example

```json
{}
```

Example result structure:

```json
{
  "total": 7,
  "value": null,
  "list": [
    { "text": "test 1", "value": 1 },
    { "text": "test 2", "value": 2 }
  ]
}
```

## Related docs

- [Actions reference](/en/actionjail/reference/actions-reference.md)