1. Overview

Note: The Deselect and Uncheck tasks are two distinct actions that serve different purposes when interacting with web elements. The Deselect task focuses on deselecting the currently selected value from a dropdown field, while the Uncheck task interacts with the checkbox.

2. Syntax

uncheck(<locator>);

Parameter	Data Type	Description
locator	STRING	Identifies the checkbox on the webpage. Note: Locators can be fetched in one of two ways, either by manually inspecting the webpage to identify the element, or by using a recorded element saved during a recording session. Learn more about Elements

3. Examples

Example 1: Removing an applied loyalty discount before checkout

Unchecks the loyalty discount checkbox on the ZWatch Commerce checkout page so the discount no longer applies to the order total.

// Open the checkout page on the ZWatch Commerce website using the Open URL task
openURL("https://zwatch.zohocommerce.com/checkout", "same window");
// Uncheck the loyalty discount checkbox using the Uncheck task
uncheck(ui.zwatch.loyalty-discount-checkbox);

where:

Example 2: Unchecking "keep me signed in" on a login page

Unchecks the "keep me signed in" checkbox on the login page, then confirms the checkbox is no longer checked.

// Open the login page on the ZWatch Commerce website using the Open URL task
openURL("https://zwatch.zohocommerce.com/login", "same window");
// Uncheck the keep me signed in checkbox using the Uncheck task
uncheck(ui.zwatch.keep-signed-in-checkbox);
// Confirm the checkbox is no longer checked using the Assert Selected task
assertSelected(ui.zwatch.keep-signed-in-checkbox, errorhandling.CONTINUE_ON_ERROR);

where:

Example 3: Clearing the Auto Reorder checkbox while editing a product record

Clears the Auto Reorder checkbox while editing a product record in the Inventory Manager application, built on Zoho Creator, using the Uncheck task.

// Open the product record in the Inventory Manager application using the Open URL task
openURL("https://creatorapp.zoho.com/zylker/inventory-manager#Form:Product_Record", "same window");
// Clear the Auto Reorder checkbox using the Uncheck task
uncheck(ui.inventorymanager.auto-reorder-checkbox);

where:

4. Use cases

Scenario 1: Removing a gift wrap option before finalizing an order

Online stores sometimes let customers add gift wrapping during checkout, then change their mind before placing the order. If unchecking the gift wrap option doesn't actually remove it, the customer could be charged for a service they no longer want.

A tester uses Zoho QEngine to verify that removing the gift wrap option updates the order total correctly. If that check failed, the customer would be charged for gift wrapping they explicitly opted out of.

1. Open the checkout page in the same window.
2. Check the gift wrap checkbox.
3. Uncheck the gift wrap checkbox.
4. Confirm the order total no longer includes the gift wrap fee.

Implementation

// Step 1: Open the checkout page on the ZWatch Commerce website in the same window using the Open URL task
openURL("https://zwatch.zohocommerce.com/checkout", "same window");
// Step 2: Check the gift wrap checkbox using the Check task
check(ui.zwatch.gift-wrap-checkbox);
// Step 3: Uncheck the gift wrap checkbox using the Uncheck task
uncheck(ui.zwatch.gift-wrap-checkbox);
// Step 4: Confirm the order total excludes the gift wrap fee using the Assert Text task
assertText(ui.zwatch.order-total, "$75.00", errorhandling.STOP_ON_ERROR);

Scenario 2: Disabling saved payment details on a shared computer

Retail sites often let customers save their payment method for faster future checkouts, but that convenience becomes a security risk on a shared or public computer. Customers need a reliable way to turn this off before stepping away.

A tester uses Zoho QEngine to verify that clearing the setting properly removes the stored payment information. If disabling the option did not take effect, a subsequent user of the same computer could potentially make purchases using another customer's payment details.

1. Open the account settings page in the same window.
2. Uncheck the save payment method checkbox.
3. Confirm no payment method remains saved.

Implementation

// Step 1: Open the account settings page on the ZWatch Commerce website in the same window using the Open URL task
openURL("https://zwatch.zohocommerce.com/account/settings", "same window");
// Step 2: Uncheck the save payment method checkbox using the Uncheck task
uncheck(ui.zwatch.save-payment-checkbox);
// Step 3: Confirm no payment method remains saved using the Assert Not Present task
assertNotPresent(ui.zwatch.saved-payment-method, errorhandling.STOP_ON_ERROR);

Scenario 3: Removing manager approval requirement from an onboarding task

Consider an HR organization that uses a Zoho Creator Onboarding application to manage new hire tasks. Each onboarding task is stored as a record in the Onboarding Tasks form. While some tasks require manager approval, HR staff can remove this requirement for specific roles by clearing the Requires Manager Approval checkbox before saving the record.

A tester uses Zoho QEngine to verify that clearing the Requires Manager Approval checkbox updates the task correctly. If the change is not saved, onboarding tasks for exempt employees could remain pending for an approval that is not required.

1. Open the Onboarding Tasks form in the Onboarding application.
2. Uncheck the Requires Manager Approval checkbox.
3. Save the record.
4. Confirm the checkbox remains unchecked after the record is saved.

Implementation

// Step 1: Open the Onboarding Tasks form in the Onboarding application using the Open URL task
openURL("https://creatorapp.zoho.com/zylker/onboarding#Form:Onboarding_Tasks", "same window");
// Step 2: Uncheck the Requires Manager Approval checkbox using the Uncheck task
uncheck(ui.onboarding.manager-approval-checkbox);
// Step 3: Save the record using the Click task
click(ui.onboarding.save-button);
// Step 4: Confirm the checkbox remains unchecked after saving using the Assert Selected task
assertSelected(ui.onboarding.manager-approval-checkbox, errorhandling.STOP_ON_ERROR);

5. Points to note

1. Use the Uncheck task only to clear a checkbox that is already checked, it doesn't act on a dropdown's selected value. Use Deselect for that instead.
2. When a checkbox doesn't have a clear label of its own, prefer a locator built from its name or id attribute over a raw full XPath string, since checkboxes are often grouped tightly together with other options nearby.

6. Related topics

1. Check
2. Select
3. Deselect
4. Clear
5. Upload

7. What's next