Skip to main content

Chips

note

The chips pattern is coming soon. The code is not yet approved.

Overview

The UI chip displays small pieces of information or tags in a visually appealing and compact manner. It's commonly used to represent categories, filters, or selections in user interfaces.

When to use

Use the chip pattern when there's a need to visually represent discrete pieces of information, such as:

  • Tagging systems
  • Filtering options
  • Selections in a multi-select interface
  • Categorization of content

Anatomy

Anatomy of a UI chip component

  1. Container that indicates at a glance different types of interactivity and functionality
  2. Optional thumbnail/avatar/icon/color swatch to distinguish between categories
  3. Label to identify the chip
  4. Optional remove or dropdown icon to remove a chip or trigger a selection menu

General guidelines

  • There must be a clear relationship between chips and the content or task they represent.
  • The purpose of UI chips is to make tasks easier to complete, or content easier to sort. Use chips sparingly and only when necessary to avoid cluttering the interface.
  • Test the chip component across various devices and screen sizes to ensure consistent rendering and usability.

Interaction guidelines

Image illustrating the 4 chip types: input, choice, filter, and action

  1. Input chips: Input chips display information the user has entered. They enable user input and clarify that input by converting text into a chip. These chips include an X icon for users to remove their selections.
  2. Choice chips: Choice chips enable single or multiple selection from a set of input options in a form. There must be a minimum of 2 options from which users can select. Choice chips can serve as an alternative to toggle buttons, radio buttons, and single select menus.
  3. Filter chips: Filter chips use relevant words to filter certain types of content. Filter chips can serve as an alternative to toggle buttons or checkboxes.
  4. Action chips: Action chips trigger an action. You can use an optional leading icon to add a visual description of the copy on the label.

Content

General writing guidelines

  • Use sentence case for all aspects of designing Guidewire product interfaces. Don't use title case.
  • Use present tense verbs and active voice in most situations.
  • Use common contractions to lend your copy a more natural and informal tone.
  • Use plain language. Avoid unnecessary jargon and complex language.
  • Keep words and sentences short.

Include a label

  • All chip types must include a label to identify the chip.
  • Keep chip labels concise and descriptive to convey meaning at a glance.
  • Use a single line of text for chip labels. Avoid using long text labels that wrap to a second line.
Do keep the text label short.
Don't use long text labels.

Accessibility

  • Ensure the flow is designed to be accessible to users with disabilities, including those who require screen reader compatibility and keyboard navigation.
  • When using chips with color swatches and icons, name the color or icon in the text label. Don't rely on color alone to convey meaning.

Responsiveness

Image illustrating how the UI chip pattern adapts to smaller form factors like mobile

The UI chip pattern is designed in such a way that minimal changes are required when used on tablet or mobile. Wrapping of the chips in the pattern may occur as the screen width shrinks.

  1. Wrapping of chips on mobile. Chips that can no longer fit in the space go onto a second line.
  2. Chips with enough space to stay on one line.

Theming

By default, theming and branding match that of the application unless overridden.

Patterns may be themed to meet specific branding requirements and customer needs. This includes visual elements such as colors, typography, icons, buttons, and other components and graphical elements.

Learn about theming with design tokens

Components

Input chips have the following related components:

Patterns

Resources

Access Figma to see how we create patterns and contribute to the next version of the drawer pattern. If you haven't used Figma before, you'll need to create a Figma account.