Ready

Picklist

A picklist displays a list of choices within a temporary, elevated container. A picklist can be used for navigation, selections or actions.

Ready

Picklist

A picklist displays a list of choices within a temporary, elevated container. A picklist can be used for navigation, selections or actions.

Ready

Picklist

A picklist displays a list of choices within a temporary, elevated container. A picklist can be used for navigation, selections or actions.

Anatomy

Anatomy

Anatomy

  1. Heading: Optional. Used as a label for the entire picklist if the picklist control does not include a label. (ex. Add new filter button, filter pill)

  2. Search: Optional. Used to search within the picklist if there are many option to choose from.

  3. List: Required. Use to show the list of available choices.

  4. Footer: Optional. Use to display "Apply" button for filter bar selections.

Variants

Variants

Variants

  1. Default

  2. Multi Select

  3. Parent Child

  4. Parent Child Single Select

States

States

States

  1. Default

  2. Loading

  3. No Results

  4. Error

Behaviors

Behaviors

Behaviors

Max Height

The list container has a max-height of 308px. Once it reaches this height, the overflow can be seen by scrolling.

Min Width and Truncation

  1. Min Width: The min-width of the picklist is 224px. The width may be increase to suit the needs of the design.

  2. End Truncation: By default, text will be truncated to 2 lines.

  3. Middle Truncation: Items may also be set to truncated in the middle if there are important identifiers at the end of the item text.

Best Practices

Best Practices

Best Practices

1. Usage

The picklist list should be used for navigation, selections or actions. It should not be used to display static information. Consider using a tooltip instead.

2. Hidden

The picklist should be hidden until opened with a control element. It should not be left open on a page as a visible element. If vertical, visible navigation is needed, consider using stacked tabs.

3. Elevation

The picklist should be elevated above the page content. The picklist should be positioned to always be visible and should not be cut off by page.

4. Unavailable Choices

Disable any unavailable choices. When user clicks a disabled choice, display a flash message explaining why the item is disabled and how to make it active. Do not remove unavailable items. This decreases spacial consistency and makes the interface harder to learn. Use this pattern with caution and try to avoid UX that creates scenarios with unavailable choices.

5. Permissions

If the user doesn't have permission to access a certain feature then it should be removed from the picklist.

6. Scrolling

Avoid long scrolling lists when possible. When a list is scrollable, not all of the choices are visible and it can be challenging for users to scroll while keeping the mouse within the picklist. If this is unavoidable, include a search input to help users navigate list.

Content

Beta

Content

Beta

Content

Beta

Keep picklist options short and simple. Unless it is an icon button, the button that triggers the picklist should include a label that clearly indicates what they will find in the menu. The button label should be a verb or verb phrase. See Buttons.

Create campaign

Upload creative

Campaigns

Upload a new creative

Picklist menu items should be short and written using parallel construction--every item should be a noun or a verb. Avoid repeating words if possible. The number of choices should be limited to 5-8 items. Additional options may be placed in a nested menu. Nested menus should be uses sparingly.

Use sentence case--only capitalize the first word.

Options should be ordered in a logical manner, such as by frequency-of-use, or alphabetically as a fallback. Group similar options together to make them easier to scan.

More

More

More

Related Components

Additional Reading

Need more guidance?

Suggest an addition or an edit.

Need more guidance?

Suggest an addition or an edit.

Need more guidance?

Suggest an addition or an edit.

© 2025 Basis Technologies
© 2025 Basis Technologies
© 2025 Basis Technologies