> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/rdm/knowledge-base/how-to-articles/rdp-session-entry/rdp-reconnect-mode.md).

# RDP reconnect mode

Compare the reconnect modes of RDP entries in Remote Desktop Manager, including Reconnect with updated credentials and the inherited default.

The ***Reconnect mode*** determines what Remote Desktop Manager does when an open session is reconnected. For ***Microsoft Remote Desktop*** entries, it can be found under ***Properties – Common – General – Advanced***. By default, the ***Default (inherited)*** option is selected.

<table><thead><tr><th width="240">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Default (inherited)</strong></td><td>Use the reconnect mode of the nearest parent folder that sets one. When no parent folder sets one, use the value of <em><strong>File – Settings – Entry types – Sessions – Remote Desktop (RDP) – Reconnect mode</strong></em>. The mode that applies is displayed next to the list. Hover over it to see the folder it comes from.</td></tr><tr><td><strong>Reconnect in a new tab</strong></td><td>Close the tab and open the session again. The session reuses the credentials resolved when it was first opened.</td></tr><tr><td><strong>Smart reconnect</strong></td><td>Use the ActiveX reconnect feature. On RDP 8.1 and later, the screen is resized when a reconnect is not needed.</td></tr><tr><td><strong>Reconnect in the same tab</strong></td><td>Call the disconnect method and then the connect method of the ActiveX, in the same tab.</td></tr><tr><td><strong>Reconnect with updated credentials</strong></td><td>Close the tab and open the session again from a fresh copy of the entry. Linked credentials and PAM accounts are resolved again, so a password that was changed or rotated while the session was open is used.</td></tr></tbody></table>

{% hint style="info" %}
It is recommended to change the ***Screen sizing mode*** to ***Smart Reconnect***, instead of selecting it in the ***Reconnect mode*** menu. The ***Screen sizing mode*** option can be found under the ***Display*** tab of the same properties menu.
{% endhint %}

{% hint style="info" %}
When the credentials are resolved again, Remote Desktop Manager can prompt again, for example when the linked credential entry prompts with a list.
{% endhint %}

### Application setting

On Windows, the value used when no entry or folder sets a reconnect mode is set in ***File – Settings – Entry types – Sessions – Remote Desktop (RDP) – Reconnect mode***. This setting offers ***Reconnect in the same tab*** (the default value), ***Reconnect in a new tab***, and ***Smart reconnect***. To use ***Reconnect with updated credentials*** for many entries, set it on a folder instead.

### Folders and other session entries

Folders have a ***Reconnect mode*** setting under ***Properties – Common – User interface – Session***. It offers the same options as the RDP entries. The entries and subfolders left on ***Default (inherited)*** use the mode of the folder.

Session entries other than RDP that open in an embedded tab also have a ***Reconnect mode*** setting under ***Properties – Common – User interface – Session***. It offers ***Default (inherited)***, ***Reconnect in a new tab***, and ***Reconnect with updated credentials***. When such an entry inherits a mode that only applies to RDP, it uses its own reconnect.

### Reconnect once with updated credentials

To resolve the credentials again for one reconnection only, without changing the reconnect mode of the entry, use one of these actions on an open session:

* ***Reconnect with updated credentials***: close the session and open it again with the credentials resolved again. This action is hidden when the reconnect mode of the entry is already ***Reconnect with updated credentials***.
* ***Refresh credentials***: resolve the credentials again and update the open session without reconnecting. Typing actions, such as typing the password, then use the new values.

Both actions are available in the ***Connection*** group of the [***Actions***](https://docs.devolutions.net/rdm/ribbon-menu-bar/actions.md) tab, in the context menu of the session tab, and in the context menu of the entry. Keyboard shortcuts can be assigned to them in the keyboard shortcut settings.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/rdm/knowledge-base/how-to-articles/rdp-session-entry/rdp-reconnect-mode.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
