Cloudscape Design System
  • Get started
  • Foundation
  • Components
  • Patterns
  • Demos
  • GitHub 
Cloudscape Design System
  • Get started
  • Foundation
  • Components
  • Patterns
  • Demos
  • GitHub 
  • About

Components


  • Alert
  • Anchor navigation
  • App layout
  • App layout toolbar
  • Attribute editor
  • Autosuggest
  • Badge
  • Board components
    • Board
    • Board item
    • Items palette
  • Box
  • Breadcrumb group
  • Button
  • Button dropdown
  • Button group
  • Calendar
  • Cards
  • Charts
    • Bar chart
    • Line chart
    • Area chart
    • Mixed line and bar chart
    • Pie and donut charts
  • Checkbox
  • Code editor
  • Code view
  • Collection preferences
  • Collection select filter
  • Column layout
  • Container
  • Content layout
  • Copy to clipboard
  • Date input
  • Date picker
  • Date range picker
  • Drawer
  • Expandable section
  • File uploading components
    • File dropzone
    • File token group
    • File input
    • File upload
  • Flashbar
  • Form
  • Form field
  • Generative AI components
    • Avatar
    • Chat bubble
    • Loading bar
    • Prompt input
    • Support prompt group
  • Grid
  • Header
  • Help panel
  • Icon
  • Input
  • Key-value pairs
  • Link
  • Live region
  • Modal
  • Multiselect
  • Pagination
  • Popover
  • Progress bar
  • Property filter
  • Radio group
  • S3 resource selector
  • Segmented control
  • Select
  • Side navigation
  • Slider
  • Space between
  • Spinner
  • Split panel
  • Status indicator
  • Steps
  • Table
  • Tabs
  • Tag editor
  • Text content
  • Text filter
  • Text area
  • Tiles
  • Time input
  • Toggle
  • Toggle button
  • Token group
  • Top navigation
  • Tutorial components
    • Annotation context
    • Hotspot
    • Tutorial panel
  • Wizard
  1. Cloudscape Design System
    • Components
    • Collection select filter
    1. Cloudscape Design System
    2. Components
    3. Collection select filter

    Collection select filter

    A select filter helps users find specific items in a collection of resources by choosing one or two properties.

    Published: November 23, 2020
    Get design library
    View in demo

    On this page

    1. Preview
    2. Features
    3. General guidelines
    4. Writing guidelines
    5. Accessibility guidelines

    Did this page help you?

    Tell us more - optional

    1000 character(s) available. Do not disclose any personal, commercially sensitive, or confidential information.

    Preview

    Collection select filter desktop imageCollection select filter desktop image
    Collection select filter mobile imageCollection select filter mobile image

    Features

    • Properties

      Display the most pertinent properties that users need to find a resource in a collection of resources. Most commonly, those properties refer to the column headers for table view and content labels for a cards view.

      We don't recommend using more than two collection select filters. Used in combination, the two filters behave as an And operator.

    • Values

      • Using the select filter, list all finite values that correspond to the property.

        • For example: Property: Status; Values: Error, Loading, Pending, Stopped, and Success.

      • Use Any {property} as the default pre-selected option. It takes into account any values that correspond to that property. The collection isn't filtered and displays all items.

      • Follow the guidelines for the select component.

    Collection view

    • Displaying results

      The collection is filtered as soon as the user selects a value from a select filter or enters text into the accompanying text filter. Only resources that match the conditions of the values are displayed. For example: Engine set to Aurora and Status set to available will show the available resources that are running the Aurora engine.

    • Loading state

      The state of the collection of resources, such as table or cards, while the filtered dataset is being loaded. Follow the guidelines for loading state for collections.

    • No match state

      The state of the collection of resources, such as table or cards, after a user applies a filter that does not return any results. In other words, the state when there are no resources that match the filters applied. Follow the guidelines for empty states.

    General guidelines

    Do

    • Always use the filter functionality on the full collection of resources, not just on visible or loaded resources.
    • Always display the number of matched resources. In table and card views, the count is shown next to the title in the table header.
    • Use a select filter for commonly used properties and values.
    • Always provide a visible label for every select filter to improve accessibility. Labels are optional for open text filters when a search icon is included in the control.
    • After a user completes a filter action, display the number of results next to the select filters.
    • Use a select filter if users need a maximum of two properties to find a specific item. If more than two are required, use a property filter instead.
    • If a select filter has two properties, the operator is always and. If you need more operators to combine properties, use a property filter instead.

    Don't

    • Don't use filtering if the majority of your users operate on small collections of resources (fewer than five resources).
    • Don’t use a select filter for collections that have a very large set of values.
    • Don’t use a select filter if users need to select multiple values that correspond to one property. Use a property filter instead.
    • Don’t change the control for the selection mechanism. Always use a select component.
    • Don’t change table column headers after a user has completed a filter action.

    Writing guidelines

    General writing guidelines

    • Use sentence case, but continue to capitalize proper nouns and brand names correctly in context.

    • Use end punctuation, except in headers and buttons. Don’t use exclamation points.

    • Use present-tense verbs and active voice.

    • Don't use please, thank you, ellipsis (...), ampersand (&), e.g., i.e., or etc. in writing.

    • Avoid directional language.

      • For example: use previous not above, use following not below.

    • Use device-independent language.

      • For example: use choose or select not click.

    Component-specific guidelines

    Placeholder text

    • Follow the writing guidelines for placeholder text.

    • Don’t use terminal punctuation.

    Label

    • Follow the writing guidelines for select.

    Select

    • Follow the writing guidelines for select.

    Results counter

    • Follow the writing guidelines for table resource counter.

    Loading state

    • Follow the writing guidelines for loading and refreshing.

    No match state

    • Follow the guidelines for empty states.

    Accessibility guidelines

    General accessibility guidelines

    • Follow the guidelines on alternative text and Accessible Rich Internet Applications (ARIA) regions for each component.

    • Make sure to define ARIA labels aligned with the language context of your application.

    • Don't add unnecessary markup for roles and landmarks. Follow the guidelines for each component.

    • Provide keyboard functionality to all available content in a logical and predictable order. The flow of information should make sense.

    Component-specific guidelines

    Alternative text

    • Follow the accessibility guidelines for select.

    Label

    • Provide a visible label using inlineLabelText property for filter controls to specify the parameter the dataset is filtered by.

      • For example: Filter engine, or Filter class.

    Did this page help you?

    Tell us more - optional

    1000 character(s) available. Do not disclose any personal, commercially sensitive, or confidential information.
    • About
    • Connect
    • Privacy 
    • Site terms 
    • © 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.
    Made with love atAWS