The **Drag mouse** block simulates a mouse drag action on the screen, moving from one point to another while holding down a mouse button. This action is useful for dragging items across the screen, selecting areas, or triggering UI behaviors that rely on click-and-drag gestures.

The block typically receives its **Start position** and **End position** from upstream blocks such as Find image, Get text, or Get number, which provide dynamic coordinates.

Fully expanded, the **Drag mouse** block shows the following properties:

**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 **Drag mouse** onto the canvas.
2. Connect dynamic values or enter coordinates for **Start position** and **End position**.
3. Adjust **Button**, **Speed**, or **Await no movement** if needed.
4. Run the flow when it’s ready.

## Building block parameters

### Parameters

- **Block header**: The green input connector triggers the block to start executing. The green output connector triggers when a screenshot has been successfully taken. You can rename the block title (“Drag mouse”) by double-clicking it and typing in a new title.

- **Start position**: Defines the screen coordinates where the drag begins. This position is specified in X and Y, relative to the top-left corner of the screen (0, 0). You can expand the field to edit both values or connect dynamic input.

- **End position**: Defines the screen coordinates where the drag ends. As with _Start position_, the values are relative to the screen’s top-left corner. You can edit X and Y separately or connect values from another block.

- **Button**: Specifies which mouse button is used for the drag. Default is **Left**, but other options may be available depending on context (e.g., right-click drag).

- **Speed**: Controls the speed of the mouse movement between the start and end points. Options include:
  - **Slow**: Gradual movement, useful for visual clarity.
  - **Medium**: Recommended default for smooth recording and playback.
  - **Fast**: Quicker than medium, less visible motion.
  - **Instantaneous**: Moves the cursor instantly without visible movement.

- **Await no movement**: Delays the drag action until no screen activity has been detected for a set period. This helps ensure stability in dynamic interfaces (e.g., page loading or animations). If enabled, the block will wait for screen stability or up to a maximum of 30 seconds.

- **Await timeout**: Specifies how many seconds the screen must remain unchanged before the drag begins. Only applies if _Await no movement_ is enabled.

## Resources

| **Topic** | **Description** |
| --- | --- |
| [Flows FAQ](https://docs.leapwork.com/faq/latest/leapwork-flow-faq/flows-faq) | Common questions about creating, running, and managing flows in Leapwork. |
| [Flows Troubleshooting](https://docs.leapwork.com/troubleshooting/latest/leapwork-flow-troubleshooting/flows-troubleshooting) | Guidelines and solutions for identifying and fixing issues that occur when building or running flows in Leapwork.