> For the complete documentation index, see [llms.txt](https://docs.wem.io/platform/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wem.io/platform/wemreference/functions/lists/isonrow.md).

# IsOnRow

{% hint style="info" %}
The **`IsOnRow()`** function returns a yes/no value that indicates that the indicated list has a specific Row selected; this can be achieved for example by using a list node (go to row), loop node (going though multiple rows in a list) or clicking on a row in a datagrid. or - in case a reference-field is used with this function - the reference-field has a value and is indeed pointing to a specific row in the referenced list (achieved using an assignment node).

When a List is on a specific row, you can access the values of the fields in the list (to read or write values). If you try to read or write specific fields in a list, when there is no current row, you will get a fault message with something like "there is no current row". So, to be sure you can access fields of a specific item in a list and to avoid this fault situation, you can check this using the IsOnRow function.

The list-node action `Reset Row Position` will set the IsOnRow to false: there will be no specific row selected on the list. The assignment action `Clear value` on a reference-field will clear the reference so it will no longer point to a specific row - the IsOnRow will in that case also yield false. 

This function is NOT SQL compatible. For more information about SQL compatibility, see our [documentation](/platform/wemreference/sql-compatibility.md).
{% endhint %}

{% hint style="success" %}
Returns <mark style="color:green;">True</mark> if the list has a specific row selected and the list-fields can be used to read/write values. Or - in case a reference-field is used - the reference field points to a specific row item in the list.

Returns <mark style="color:red;">False</mark> if the list has no current active row which can be used, or - in case a reference-field is used - the reference field is not yet set to point to a specific row (or has been cleared with an assignment node)
{% endhint %}

### Syntax

<details>

<summary><code>IsOnRow(</code><mark style="color:blue;"><code>list</code></mark><code>)</code></summary>

`IsOnRow( [Users] )`\
\&#xNAN;*=> yes - when there is actually a specific row selected in the list.*

`IsOnRow( [Products] )`\
\&#xNAN;*=> no - when there is no current active row in Products.*

</details>

<details>

<summary><code>IsOnRow(</code><mark style="color:blue;"><code>reference</code></mark><code>)</code></summary>

`IsOnRow( [CurrentUser-Reference] )`\
\&#xNAN;*=> yes - when the CurrentUser reference field is pointing to an actual row in the Users list.*

`IsOnRow( [ClearedProduct-Reference] )`\
\&#xNAN;*=> no - when the reference field has been cleared and is not pointing to an actual row in the list.*

</details>

### Parameters

<table><thead><tr><th width="150">Name</th><th width="150">Type</th><th width="150" align="center">Required</th><th width="248.15953250810662">Description</th><th data-hidden>Required?</th></tr></thead><tbody><tr><td><mark style="color:blue;"><code>list</code></mark></td><td>list</td><td align="center"><span data-gb-custom-inline data-tag="emoji" data-code="2611">☑️</span></td><td>a list</td><td>yes</td></tr><tr><td><mark style="color:blue;"><code>reference</code></mark></td><td>reference</td><td align="center"><span data-gb-custom-inline data-tag="emoji" data-code="2611">☑️</span></td><td>a reference field pointing to a specific list</td><td></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.wem.io/platform/wemreference/functions/lists/isonrow.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.