# Connect to Session

The **Connect to Session** block is used to attach to an active terminal session during execution. This is required before interacting with mainframe or green screen interfaces using Leapwork’s terminal automation capabilities.

**Note:** A terminal session must already be active for this block to connect successfully. You can use desktop building blocks to build a sub-flow that starts the session automatically. Setup steps may vary depending on the terminal type, such as IBM i Access or Rumba+ Desktop.

**The Green Screen Recorder and building blocks are available with Enterprise plans.**

**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 **Connect to Session** onto the canvas.
2. Specify the basic parameter required for this block to operate: **Terminal session type**.
3. Run the flow when it’s ready.

## Building block parameters

### Parameters

- **Block header**: The green input connector triggers the block to begin execution. The green output connector triggers when a terminal session is successfully connected. You can rename the block title by double-clicking it and typing in a new title.

- **Terminal session type**: Selects which terminal session to connect to. Leapwork supports sessions **A–Z** (uppercase) and lets you switch between sessions within the same flow. **Automatic** connects to the latest active session.

- **Error occurred**: Triggers if **Connect to Session** returns an error during execution, so you can branch your flow.

- **Default timeout**: If the checkbox is not selected, the timeout is **10 seconds** unless changed manually. If the checkbox is selected, the flow’s **Default timeout** under **Max. run time** applies.

- **Timeout (sec)**: The maximum time spent trying to connect to the terminal session before giving up. This value is used when **Default timeout** is not selected.

## 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.