# Get Text From Object

This pre-built Action is located under the **@Custom Element.** The functionality of this action in Avo Assure to retrieve the text of the object and save the result in dynamic variable.

### Syntax

**Input Value:** `<Object Type>;<VisibleText(Optional)>;<index>;<abs(optional)>`

| Argument                            | Description                                                                                                               |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| <p>\<Object Type><br>(Required)</p> | Specific type of object whose text is to be retrieved.                                                                    |
| <p>\<VisibleText><br>(Optional)</p> | The visible text associated with the object.                                                                              |
| <p>\<index><br>(Required)</p>       | Provide the position of the element, which helps to identify the value based on the sequence in list . (starting from 0)​ |
| <p>\<abs><br>(Optional)</p>         | If the **abs** is provided, the action is performed with absolute identification using the **absolute X path**            |

{% hint style="warning" %}
**Note:** If last argument abs is defined then the Action must be executed with absolute preformation with the specified **absolute X path** in the input.

*To skip an optional input value, use an extra semicolon (;).*
{% endhint %}

**Output Value**

| Argument                                 | Description                                                            |
| ---------------------------------------- | ---------------------------------------------------------------------- |
| <p>\<Dynamic Variable><br>(Required)</p> | This variable holds the exacted text from the object                   |
| <p>\<Dynamic Variable><br>(Optional)</p> | This variable holds the status of the action as **True** or **False**. |

**Example 1**

**Retrieves the visible text content from a specified UI element in the application**

The **Get Text From Object** action takes the value from the Input Value column (e.g.,**button;;0**) and extracts the text from the specified object. The retrieved text is stored in the **{Text}** variable, while the execution status is stored in the **{Status}** variable, with the following possible values:

* **True** – if the text is retrieved successfully.
* **False** – if retrieval fails

<figure><img src="https://2174257472-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fk8QZzXZMIJSStKAzDSTu%2Fuploads%2Fd0W0Le5YwGs1wLWovlwh%2Fimage.png?alt=media&#x26;token=16276721-270a-4fa2-8ce8-aa989466e8ce" alt=""><figcaption></figcaption></figure>

**Example 2**

**Retrieves the visible text content from a specified UI element using optional parameter**

The **Get Text From Object** action takes the value from the Input Value column (e.g.,**button;Click Me;0;//\*\[@id="oTN9K"]**) and extracts the text from the specified object. The retrieved text is stored in the **{Text}** variable, while the execution status is stored in the **{Status}** variable, with the following possible values:

* **True** – if the text is retrieved successfully.
* **False** – if retrieval fails

<figure><img src="https://2174257472-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fk8QZzXZMIJSStKAzDSTu%2Fuploads%2FMODVrf5sqQ0j6iweHcXu%2Fimage.png?alt=media&#x26;token=d9bc4694-fce4-4758-9eb9-74fcd9d672d8" alt=""><figcaption></figcaption></figure>