Transfer list

A transfer list, also known as a dual listbox, is a user interface component that allows users to move a selection of items from one list to another. It typically consists of two adjacent lists with controls to move items between them.

When to use

Selecting multiple items from a large dataset

It's ideal when users need to assign users to a group, select columns for a report, or choose options for configuration.

Selecting multiple items from a large dataset

It's ideal when users need to assign users to a group, select columns for a report, or choose options for configuration.

Clear distinction between states

Use it when there is a clear included and excluded state for a group of items. The two lists provide an immediate visual representation of which items have been chosen.

Clear distinction between states

Use it when there is a clear included and excluded state for a group of items. The two lists provide an immediate visual representation of which items have been chosen.

Bulk actions

It's efficient for users to select several items at once before moving them in a single action.

Bulk actions

It's efficient for users to select several items at once before moving them in a single action.

When to avoid

Few items

If there are only a handful of items to choose from (e.g., less than 5), a simple group of checkboxes or toggle switches is more straightforward and requires less screen space.

Few items

If there are only a handful of items to choose from (e.g., less than 5), a simple group of checkboxes or toggle switches is more straightforward and requires less screen space.

Single selection

For scenarios where only one item can be selected from a list, a dropdown menu or a set of radio buttons is a more appropriate component.

Single selection

For scenarios where only one item can be selected from a list, a dropdown menu or a set of radio buttons is a more appropriate component.

Mobile interfaces

The side-by-side layout of a transfer list can be difficult to use on small screens. Consider an alternative pattern, like a multi-select list that navigates to a separate screen to show selections.

Mobile interfaces

The side-by-side layout of a transfer list can be difficult to use on small screens. Consider an alternative pattern, like a multi-select list that navigates to a separate screen to show selections.

Specifications

Behavior

Selection

Users can select one or more items by clicking their checkboxes. The transfer controls act only upon the selected items.

Filtering

As a user types into a search field, the associated list filters in real-time. The search should apply to all items within that list, regardless of their group.

Bulk transfer