> 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.md).

# Touch

Touch clicks or taps a control. Use it for buttons, links, checkboxes, and other interactive [Elements](/elements/creating-elements.md). Touch waits for the Element to be ready, scrolls it into view, then clicks.

Prefer Element mode for durable Flows. Use position mode only when the target has no stable Element yet.

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

## When to use it

* Click a button, link, or other control after you have defined an Element.
* Open a mobile menu before a later step when the control is hidden on a small viewport.
* Use **Mode Event** when an overlay sits over the Element.

For hover menus, use [Hover](/test-steps/action/hover.md) first. For holding a press, use [Touch and Hold](/test-steps/action/touch-and-hold.md).

## Configure

### Basics

| Field             | What to set                                       |
| ----------------- | ------------------------------------------------- |
| **Type**          | `Element` (default) or `position`                 |
| **Element**       | The Element to click (Element type)               |
| **Position Type** | `Percentage` (default) or `Pixel` (position type) |
| **X** / **Y**     | Where to click when Type is position              |

### Advanced

| Field                                 | What to set                                                                                                                          |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **Modifiers**                         | Optional `Shift`, `Ctrl`, `Windows`, or `Alt` held during the click                                                                  |
| **Mode**                              | `Area` (default) clicks the visible target area. `Event` sends the click to the Element directly, which helps with stubborn overlays |
| **X Offset** / **Y Offset**           | Fine-tune the click point on the Element (`Center` by default)                                                                       |
| **How fast is this typically?**       | [Timeout Override](/test-step-options/timeout-override.md) (`Fast`, `Slow`, `Very Slow`)                                             |
| **Status on fail**                    | [Failed Status](/test-step-options/failed-status.md)                                                                                 |
| **When should screenshots be taken?** | `Always` (default) or `On Failures`                                                                                                  |

{% hint style="info" %}
**Pro tip:** You usually do not need a Wait or Scroll before Touch. Touch already waits for the Element and scrolls it to the centre before clicking.
{% endhint %}

## Related

* [Double Tap](/test-steps/action/double-tap.md)
* [Hover](/test-steps/action/hover.md)
* [Touch and Hold](/test-steps/action/touch-and-hold.md)
* [Element states](/test-step-options/element-states.md)
* [Action](/test-steps/action.md)

**Tags:** `action`, `touch`, `click`, `tap`, `mouse`