> For the complete documentation index, see [llms.txt](https://docs.does.qa/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.does.qa/test-steps/action/touch-release.md).

# Touch Release

Touch Release lifts a press on an [Element](/elements/creating-elements.md) or screen position. Use it after [Touch and Hold](/test-steps/action/touch-and-hold.md) to complete drag-and-drop or long-press gestures.

![Touch Release Test Step](https://app.does.qa/screenshots/node/action_touch_up.png)

## When to use it

* Drop an item after dragging it from a held touch on another control.
* End a long-press sequence on a different Element than where the hold started.
* Pair with [Touch and Hold](/test-steps/action/touch-and-hold.md) for gestures that span more than one step.

## Configure

### Basics

| Field                             | What to set                                                                |
| --------------------------------- | -------------------------------------------------------------------------- |
| **Type**                          | `Element` (default) or `position`                                          |
| **Element** *(conditional)*       | The [Element](/elements/creating-elements.md) to release on (Element type) |
| **Position Type** *(conditional)* | `Percentage` (default) or `Pixel` (position type)                          |
| **X** *(conditional)*             | `Left Edge` or horizontal position when Type is position                   |
| **Y** *(conditional)*             | `Top Edge` or vertical position when Type is position                      |

### Advanced

| Field                        | What to set                                              |
| ---------------------------- | -------------------------------------------------------- |
| **Modifiers**                | Optional `Shift`, `Ctrl`, `Windows`, or `Alt`            |
| **Mode** *(conditional)*     | `Area` (default) or `Event`                              |
| **X Offset** *(conditional)* | Fine-tune horizontal release point (`Center` by default) |
| **Y Offset** *(conditional)* | Fine-tune vertical release point (`Center` by default)   |
| **Status on fail**           | [Failed Status](/test-step-options/failed-status.md)     |

## Related

* [Touch and Hold](/test-steps/action/touch-and-hold.md)
* [Touch](/test-steps/action/touch.md)
* [Drag and Drop](/test-steps/action/drag-and-drop.md)
* [Action](/test-steps/action.md)

**Tags:** `action`, `touch`, `down`, `click`, `mouse`, `hold`
