# Configure Custom Property

### Ways to build Custom Property  

**A.** Custom 1

**B.** Custom 2 

#### **A. Steps to Configure Custom 1 Property form Avo Assure Client** 

1. Launch the **Avo Assure Client.** 
2. Navigate to the **Configuration** tab. 
3. Select **Settings** option. 
4. Enter **Element Property** in the **Custom Property** field. 

{% hint style="danger" %}
**Note:**\
 Enter the unique property of the Element (e.g., data-testid, data-val-required, custom-id). 
{% endhint %}

<figure><img src="/files/UpcYL98MlBtMoGb1TjhZ" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="warning" %}
***Note:** When a custom property is defined in the Avo Assure Client settings, it is automatically captured during element identification—**provided the element contains that property**. Additionally, the captured custom property is placed **at the top of the priority list** for element identification.*
{% endhint %}

This tells Avo Assure to use this custom property during execution if the usual properties (like id or class) don’t work.

**B. Steps to Configure Custom 2 Property from Element Repository**&#x20;

1. Navigate to the **Element Repository** tab.
2. Select the required element from the repository and click **Edit** icon. The **Details** panel will appear on the right side of the screen.

<figure><img src="/files/KCr4nxpIpPAxrg3MZGoc" alt=""><figcaption></figcaption></figure>

5. In the **Custom 2 Value** field, enter the unique property of the Element  (e.g., data-testid, data-val-required, custom-id).
6. Click **Save properties** button to apply and save the changes.

<figure><img src="/files/1TUKz6MnsmlR1TedWozn" alt=""><figcaption></figcaption></figure>

### How to Use Custom Property with Self-Healing

Avo Assure also supports Self-Healing, which means it can update element properties automatically when something changes in the application. You can use Custom 1 in this self-healing process after doing a simple setup in the Avo Assure Client.

### How It Works During Execution&#x20;

**Once you’ve added the custom property in Avo Assure Client settings, follow the steps below to use it during self-healing**:&#x20;

1. Select the element that is not working during execution.&#x20;
2. Choose both options:&#x20;

* Adjust the broken element’s attributes&#x20;
* Preserve the properties of reprioritized items for subsequent execution&#x20;

**What will happen next**&#x20;

* Avo Assure automatically maps Custom 1 to the previously entered property.&#x20;
* If an element cannot be located using the default properties, the tool falls back on the custom property for identification.&#x20;
* This ensures consistent identification of the same element across test executions.&#x20;
* The test case proceeds without interruption, eliminating the need for manual intervention.&#x20;

{% hint style="warning" %}
***Note:** Make sure the custom property you entered (e.g., data-val-requiredor, maxlength) is used throughout the application by your development team.*&#x20;
{% endhint %}

#### **Example 1: Configure and Use Custom 1 Property**

**Scenario:**

In an application, elements are uniquely identified using the attribute **data-testid**, which is not part of the default properties captured by Avo Assure.

**Input:**

* Property Name to be configured: **data-testid**
* Element captured from the application using Avo Assure Client.

**Expected Result:**

The **data-testid** property is captured as **Custom 1** in the Element Repository and used during execution if default properties fail.

**Output:**

During execution, if the element is not found using **id, name,** or **class**, Avo Assure automatically uses the **data-testid** property defined in Custom 1 to identify the element and continue execution without failure.

#### **Example 2: Configure and Use Custom 2 Property**

**Scenario:**

An element in the application has a unique property **data-val-required.** The default attributes like `id` or **class** are dynamic and unreliable. The tester manually sets **data-val-required** as Custom 2 in the Element Repository.

**Input:**

* Property set in Custom 2: **data-val-required**
* All other attribute values set to **None** in the Element Repository.

**Expected Result:**

Custom 2 is used as the primary identifier to locate the element during execution.

**Output:**

Avo Assure identifies the element using the **data-val-required** value set in Custom 2 and executes the test steps successfully.


---

# 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.avoautomation.com/avo-assure/working-with-the-avo-assure-platform/create-and-execute-tests-with-design-studio/working-with-element-repository-section/custom-property/configure-custom-property.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.