> 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/knowledge-base-articles/entry-settings/password-list.md). # Password list Configure Password list entries in Remote Desktop Manager to store several credentials in one entry, with sort order, OTP, copy actions, and CSV import. The ***Password list*** credential entry stores several credentials in a single entry. Each item of the list has its own username, password, domain, and host, and can also hold a one-time password (OTP), custom fields, and an expiration date. ### Items The properties of a ***Password list*** entry display the list of its items. The list editor on Windows differs from the one on macOS and Linux. {% tabs %} {% tab title="Windows" %} The list displays the ***Name***, ***Host***, ***User***, ***Domain***, ***Description***, ***Expiration***, and ***OTP*** columns of the items.

SETTINGS	DESCRIPTION
Add	Open the Password list item window to create an item.
Edit	Open the selected item in the Password list item window.
Duplicate	Open a copy of the selected item in the Password list item window.
Delete	Remove the selected item from the list, after a confirmation.
Search	Filter the items displayed in the list.
Default sort priority	Order in which the items are listed and offered when an item must be selected: Sort priority value — highest Sort priority value first, then by name and username. User Description Expiration Host Name

To add an item to the list: 1. Right-click the ***Password list*** entry and select ***Properties***. 2. Click ***Add***. 3. Enter the item information in the ***Password list item*** window. 4. Click ***Save*** to close the ***Password list item*** window. 5. Click ***Save*** to save the entry. {% endtab %} {% tab title="macOS and Linux" %} The list displays the ***Name***, ***Host***, ***User***, ***Password*** (masked), ***Domain***, ***Description***, ***Expiration***, and ***OTP*** columns of the items. The ***Name*** column displays an ***Expired*** or ***Expiring soon*** badge (expiration within 30 days), and an icon for items restricted to user groups or users.

SETTINGS	DESCRIPTION
Add item	Create an item at the top of the list. When the Details pane is displayed, the new item is edited in the pane; otherwise, the Password list item window opens.
Edit	Open the selected item in the Password list item window.
Duplicate	Add a copy of the selected item to the list.
Delete	Remove the selected item from the list, after a confirmation.
Paste items	Create items from text copied from a spreadsheet, a CSV file, or a plain list. The columns are read in the order Name, Host, User, Domain, Password, Description; select First line holds the column names to match the columns by name instead. Lines with no name and no host are ignored. The Preview lists the items before they are added.
Move up and Move down	Move the selected item in the list. Items can also be dragged. Available when Order is set to Manual and the list is not filtered.
Order	Order in which the items are listed and offered when an item must be selected: Manual — the order set by dragging the items or with Move up and Move down. User Description Expiration Host Name
Search	Filter the items displayed in the list.
Summary	Show or hide the summary bar, which counts the items and filters the list on All, Expired, Expiring soon, With OTP, or Restricted to roles.
Details	Show or hide the Details pane, which edits the selected item directly in the list, in the Overview, Expiration, Custom fields, Visible to, and Description groups. The Expiration group also offers In 30 days, In 90 days, and In 365 days to extend the expiration date. The pane is displayed by default.

An item left with no name, host, username, and password is not saved. To add an item to the list: 1. Right-click the ***Password list*** entry and select ***Properties***. 2. Click ***Add item***. 3. Enter the item information in the ***Details*** pane. 4. Click ***Save*** to save the entry. {% endtab %} {% endtabs %} On iOS and Android, the ***Passwords*** list displays the ***Host***, ***User***, ***Domain***, ***Description***, and ***Expiration*** of the items. Tap ***Add*** to create an item in the ***Add credential*** form, or tap an item to modify it. The ***Default sort priority*** setting offers the same choices as on Windows. The item form contains the same fields as the ***Password list item*** window, except custom fields and user group restrictions, which cannot be edited on iOS and Android. ### Password list item The ***Password list item*** window opens from the item list on Windows, macOS, and Linux. It is divided into sections. The ***Save*** button is available once the item has a username or a password. **General**

SETTINGS	DESCRIPTION
Name	(Optional) Name of the item, used to identify it in the list.
Host	(Optional) Host, IP address, or URL associated with the item. Navigate URL opens this value.
Username	Username of the item.
Domain	(Optional) Domain of the item.
Password	Password of the item. The password can be generated with the password generator.

**Description**

SETTINGS	DESCRIPTION
Description	(Optional) Notes about the item.
Expires after	Set an expiration date for the item. When this option is selected, the Expiration date picker is displayed. An expired item cannot be used to open a session or to copy its credentials: Remote Desktop Manager displays "This entry is expired".
Sort priority	Number used to order the item when Default sort priority is set to Sort priority value. Items with a higher value are listed first. On macOS and Linux, this field is not displayed: the order is set in the list of items.

**One-time password (OTP)**

SETTINGS	DESCRIPTION
Key	Secret key of the one-time password. The Load from image button reads the key from a QR code image.
Account	Account name associated with the one-time password.
Recovery codes	Open the list of recovery codes of the account.
Advanced	Open the advanced one-time password settings.
Application	Application name included in the QR code.

**Custom fields**

SETTINGS	DESCRIPTION
Add	Add a custom field, with a name and a value, to the item.
Edit	Modify the selected custom field.
Delete	Remove the selected custom field.
Copy to clipboard	Copy the value of the selected custom field to the clipboard.

**Roles**

SETTINGS	DESCRIPTION
User groups or users	Select the user groups and users allowed to see the item. An item with no user group or user is visible to everyone who can see the entry. This section is displayed only when the workspace supports roles on password list items.

### Actions The following actions are available in the ***Actions*** pane of the dashboard and in the context menu of a ***Password list*** entry. The actions that use a single item prompt to select one when the list holds more than one item. On Windows, they take the item selected in the ***Password list*** tab of the dashboard, and prompt only when no item is selected there.

SETTINGS	DESCRIPTION
View password	Open the Password list window, which lists the items of the entry with actions to reveal the password and copy the values of the selected item. On iOS and Android, select an item to display its credentials.
View one-time password	Display the one-time password of the item. Available when at least one item of the list has a one-time password key. The selected item must have a one-time password.
Copy one-time password	Copy the one-time password of the item to the clipboard. Available when at least one item of the list has a one-time password key.
Copy username and password	Copy the username of the item, then offer its password as the next paste. On Windows, in Chromium browsers and Electron applications such as Slack or Microsoft Teams, press `Ctrl`+`Alt`+`V` after pasting the username to move to the password. On macOS and Linux, any application that reads the clipboard moves it to the password. For more information, consult Clipboard. This action is not available on iOS and Android.
Copy username	Copy the username of the item to the clipboard.
Copy password	Copy the password of the item to the clipboard.
Copy domain	Copy the domain of the item to the clipboard.
Navigate URL	Open the Host of the item in an embedded web browser, with the username, password, and domain of the item. Nothing opens when the item has no host. On Linux, this action opens the entry instead of the host of an item. This action is not available on iOS and Android.
Add password to the list	Open the properties of the entry directly on a new item. On macOS, open the Password list item window instead: Save adds the item and saves the entry. This action is not available on iOS and Android.

### Import password list items from a CSV file To create ***Password list*** entries with many items at once, import a CSV file with the ***Import generic CSV wizard***. Rows that share the same name and folder are merged into one entry. See [Import a CSV file as a password list with hostnames](/rdm/knowledge-base/how-to-articles/import-a-csv-file-as-a-password-list-with-hostnames.md) for the required columns and an example file. ### Manage password list items with PowerShell The [Devolutions PowerShell module](https://docs.devolutions.net/powershell) includes cmdlets to manage the items of a ***Password list*** entry: * [Add-RDMEntryPasswordListItem](https://docs.devolutions.net/powershell/powershell-commands/add-rdmentrypasswordlistitem): adds an item and keeps the existing ones. * [Get-RDMEntryPasswordListItem](https://docs.devolutions.net/powershell/powershell-commands/get-rdmentrypasswordlistitem): lists the items, optionally filtered by item name (wildcards are supported). * [Set-RDMEntryPasswordListItem](https://docs.devolutions.net/powershell/powershell-commands/set-rdmentrypasswordlistitem): modifies an item. Only the parameters you specify are changed. * [Remove-RDMEntryPasswordListItem](https://docs.devolutions.net/powershell/powershell-commands/remove-rdmentrypasswordlistitem): removes an item and keeps the other ones. * [New-RDMPasswordListItemCustomField](https://docs.devolutions.net/powershell/powershell-commands/new-rdmpasswordlistitemcustomfield): creates a custom field to pass to the ***CustomField*** parameter of ***Add-RDMEntryPasswordListItem*** or ***Set-RDMEntryPasswordListItem***. The entry is passed through the pipeline, or with the ***InputObject*** parameter. The changes are made to the entry in memory only: add the ***Set*** switch to save the entry, or call ***Set-RDMEntry*** afterwards. Every item must have at least a username or a password. The following examples use a ***Password list*** entry named ***Web Servers***. **Create a password list entry** ***New-RDMEntry*** creates a ***Credential*** entry; set its credential type to ***PasswordList*** before saving it. ```powershell $entry = New-RDMEntry -Name 'Web Servers' -Type Credential -Group 'Infrastructure' $entry.Credentials.CredentialType = 'PasswordList' Set-RDMEntry -InputObject $entry $entry = Get-RDMEntry -ID $entry.ID ``` **Add items** ```powershell $entry | Add-RDMEntryPasswordListItem -Name 'admin' -Username 'admin' -Password 'Example-Pass-01' -Host 'web01.example.local' $entry | Add-RDMEntryPasswordListItem -Name 'deploy' -Username 'deploy' -Password 'Example-Pass-02' -Host 'web01.example.local' -Description 'Deployment service account' -Set ``` The first command only adds the item to the entry in memory; the ***Set*** switch on the second command saves both items. The ***Password*** parameter accepts a string or a secure string. **List items** ```powershell Get-RDMEntry -Name 'Web Servers' | Get-RDMEntryPasswordListItem ``` Items the current user is not allowed to see are not returned. The ***Name*** parameter filters on the item name; items imported from a CSV file have no item name, so filter them on another property instead: ```powershell Get-RDMEntry -Name 'Web Servers' | Get-RDMEntryPasswordListItem | Where-Object { $_.User -eq 'deploy' } ``` **Update an item** ```powershell $entry = Get-RDMEntry -Name 'Web Servers' $item = $entry | Get-RDMEntryPasswordListItem -Name 'deploy' $entry | Set-RDMEntryPasswordListItem -Item $item -Password 'Example-Pass-03' -Description 'Password rotated' -Set ``` **Remove an item** ```powershell $entry = Get-RDMEntry -Name 'Web Servers' $item = $entry | Get-RDMEntryPasswordListItem -Name 'admin' $entry | Remove-RDMEntryPasswordListItem -Item $item -Set ``` {% hint style="info" %} To configure the one-time password (OTP) of an item, use ***Set-RDMEntryOTP*** with its ***PasswordListItemID*** parameter, set to the ***Id*** of the item. {% endhint %} --- # 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/knowledge-base-articles/entry-settings/password-list.md?ask=&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.