--- version: "2026.1.0" language: "en" --- # Set Electron Checkbox The **Set Electron Checkbox** block sets the state of a checkbox in an Electron application by locating the checkbox element and applying the selected state. If the element cannot be found within the timeout behavior, the block triggers **Not found** so you can branch the flow. Fully expanded, the **Set Electron Checkbox** block shows the following properties: ![image-20260203-150259.png](https://docs.leapwork.com/__attachments/a_411368e38c2dcef4315fa0c9e21acb44a7cb59e21af25ccdd1fbb49d93cefb6d/image-20260203-150259.png?cb=abc6b2f2f1bb781a2035463039b7fd87) **Note:** The screenshot on this page uses the **Elegance Design** , introduced in **2025.3**. If you are using an earlier version, your layout may look different. ## Quick-start 1. Drag **Set Electron Checkbox** onto the canvas. 2. Connect the block in the flow and specify **Select Electron Checkbox to find** (required), then choose **Set Checkbox state** . Optionally set **Source element** , **Electron window** , and **Use occurrence**, and configure timeout/search behavior settings if needed. 3. Run the flow when it's ready. ## Building block parameters Parameters * **Block header** : The green input connector triggers this block to begin execution. The green output connector triggers when the Electron checkbox is successfully set. You can rename the block by double-clicking the header text and typing in a new title. * **Select Electron Checkbox to find** : **Required.** Contains the locator for the Electron checkbox to be found. Capture a locator by right-clicking the property and selecting **Capture new Electron Checkbox** . Clear the locator by right-clicking and selecting **Clear Electron Checkbox** . * **Set Checkbox state**: Selects the checkbox state to apply. * **Set check**: Ticks the checkbox. * **Set uncheck** : Unticks the checkbox. * **Found element** : Contains the found Electron element in the application window. You can reuse it as a **Source element** in other blocks to narrow down searches (for example, locating table cells inside a specific container). * **Not found** : Triggers if the Electron element is not found before the timeout. This is typically used to branch the flow or explicitly fail a case by linking it to a **Fail** block. * **Position found** : Outputs the application canvas position where the Electron element was found as **X, Y** coordinates. The top-left corner of the application canvas is **0, 0** . * **Area found** : Outputs the application canvas position and size of the found Electron element as **X, Y, Width, Height** , starting with the upper-leftmost pixel. The top-left corner of the screen is **0, 0** . * **Attributes** : Outputs all attributes on the found Electron element as **key: value** pairs, including standard HTML attributes (for example class, style, href) and custom attributes (for example data-xxx). If you need to work with a single attribute directly, use **Get Electron Attribute**. * **CSS values** : Currently unused. * **Visible** : Returns **True** if the found Electron element is visible. * **Tag name** : Returns the tag name of the found Electron element (for example div, tr, button, input). * **Source element** : Limits the Electron element locator to only work inside the provided source element when you choose the **Element** option. * **Electron window** : Contains a handle to the Electron window once it is found and focused. Use this when multiple windows are open to direct the block to operate on a specific window. * **Use occurrence** : Selects which occurrence of the Electron element to use if more than one match is found. Select **All** to iterate through all occurrences. * **Count** : Outputs the total number of found Electron elements that match the locator. * **Default timeout** : Controls whether the block uses the default timeout from the flow settings or a custom timeout value. * **Timeout (sec)** : Sets the maximum time spent searching for the Electron element before the block gives up and triggers **Not found** . This field is used when **Default timeout** is not selected. * **Scroll to find** : Controls whether the block scrolls while searching for the Electron element. When a value other than **None** is selected, the block uses scrolling during the search. * **Require valid images** : When enabled, any locator that is set to find an image (**img** tag) also validates that the image loads correctly. * **Scroll into view** : When enabled, any found Electron element is automatically scrolled into view. * **Await not found** : When enabled, the block assumes the Electron element is currently present and waits until it can no longer be found before proceeding. * **Await DOM change** : Delays the search until there have been no DOM changes for a specified period (for example, three seconds). This is useful when waiting for behind-the-scenes JavaScript updates. Regardless of this checkbox, the search and action occur after waiting a maximum of **30 seconds** . * **Await Requests** : Delays the search until there have been no active XHR requests for a specified period (for example, three seconds). Regardless of this checkbox, the search and action occur after waiting a maximum of **30 seconds**. ## Resources | **Topic** | **Description** | |---------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------| | [Flows FAQ](https://docs.leapwork.com/faq/latest/leapwork-flow-faq/flows-faq.md) | Common questions about creating, running, and managing flows in Leapwork. | | [Flows Troubleshooting](https://docs.leapwork.com/troubleshooting/latest/leapwork-flow-troubleshooting/flows-troubleshooting.md) | Guidelines and solutions for identifying and fixing issues that occur when building or running flows in Leapwork. | | [Electron Troubleshooting](https://docs.leapwork.com/troubleshooting/latest/leapwork-flow-troubleshooting/electron-troubleshooting.md) | Guidance and solutions for diagnosing and resolving issues related to Electron-based automation and environments |