# List Action

![](https://1449034948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L_NpOsk0sjotPXNy29Q%2Fuploads%2Fk1i5z1TMBIDV6Fw2jiRS%2Flist-node.svg?alt=media\&token=9e18385b-9ed7-4c69-80e9-8a5b7356c6ab)

The list node is used to work with lists. When a list node is reached an action can be performed on the list defined by the list node.

When a list node is created, WEM presents a popup where the list for which the action should take place is selected:

![](https://1449034948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L_NpOsk0sjotPXNy29Q%2Fuploads%2Fidj4DXZ7GxN0sBsWovWb%2FFlowchart-list%20node%20add.png?alt=media\&token=dd86e6ba-e1e4-4ea6-9901-f8b13c9b54b7)

The properties and exits of a list node depend on the type of action that should be performed. The property table below presents all options:

| Item                | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Exits                                                                                                       |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------- |
| **Name**            | This is set to the action that is performed on the specified list. This property is set by WEM and cannot be changed.                                                                                                                                                                                                                                                                                                                                                                                              | N/A                                                                                                         |
| **Limit to parent** | <p>(only for goto row actions)<br>When turned on, only direct children of the current row are considered. When turned off, all rows of this list are considered, also those of other parent rows. </p>                                                                                                                                                                                                                                                                                                             |                                                                                                             |
| **Action**          | **Add Row** This adds a new row in the specified list                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Default exit                                                                                                |
|                     | **Delete current row** Deletes the current row of the list that is specified                                                                                                                                                                                                                                                                                                                                                                                                                                       | Default exit                                                                                                |
|                     | **Delete multiple rows** This deletes multiple rows of a list. This property requires a second property: **Delete rows that match** Two possibilities: 1. Delete all rows of the list (this is the default value) 2. Specify the rows to delete by building an expression with the WEM expression builder                                                                                                                                                                                                          | Default exit                                                                                                |
|                     | **Goto first row…** Go to the first row that matches a certain condition. When this option is used, a second property is required: **Goto first row that matches** Two possibilities: 1. The first row that was added to the list 2. Specify the first row using an expression. When this action is selected, there is also the possibility to create an expression that defines the order of the rows in the list. You can do this by clicking the `Edit order` button that appears when this action is selected. | Default exit                                                                                                |
|                     | **Goto last row…** Go to the last row that matches a certain condition. When this option is used, a second property is required: **Goto last row that matches** Two possibilities: 1. The last row that was added to the list 2. Specify the last row using an expression When this action is selected, there is also the possibility to create an expression that define the order of the rows in the list. You can do this by clicking the `Edit order`button that appears when this action is selected.         | Default exit `Not found`: This exit is used when the expression that is used results in no applicable rows  |
|                     | **Goto next row…** Go to the next row that matches a certain condition. When this option is used, a second property is required: **Goto next row that matches** Specify the next row using an expression. When this action is selected, there is also the possibility to create an expression that defines the order of the rows in the list. You can do this by clicking the `Edit order` button that appears when this action is selected.                                                                       | Default exit `Not found`: This exit is used when the expression that is used resultas in no applicable rows |
|                     | **Goto previous row…** Go to the previous row that matches a certain condition. When this option is used, a second property is required: **Goto previous row that matches** Specify the previous row using an expression.  When this action is selected, there is also the possibility to create an expression that defines the order of the rows in the list. You can do this by clicking the `Edit order` button that appears when this action is selected.                                                      | Default exit `Not found`: This exit is used when the expression that is used results in no applicable rows  |
|                     | **Clear row position** This action clears the row position, so no row is  selected after this action                                                                                                                                                                                                                                                                                                                                                                                                               | Default exit                                                                                                |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.wem.io/platform/wemmodeler/flowcharts/list-action.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
