Skip to main content
The ButtonRow component renders a row of specified Button components. Use this component when you want to include multiple buttons in a row. When the number of included buttons exceeds the available space, the extra buttons will be presented as a Dropdown style button, which you can configure using the dropDownButtonOptions prop.
design-guide-button-row-component
  1. Primary button: use for the most frequently-used or important actions.
  2. Secondary button: typically paired with a primary and/or destructive button.
  3. Destructive button: only use for actions that are destructive, paired with a secondary button.

Props

PropTypeDescription
Buttons that exceed available space will be presented in one Dropdown style button. You can use the dropDownButtonOptions prop to customize its appearance. This prop takes an object that can include size, text, and variant fields. The size and variant fields use the same options available for those props in the Dropdown component.
buttonrow-dropdown-variants
Comma-separate values in dropDownButtonOptions to configure multiple options.
buttonrow-dropdown-multiple-values-example

Usage examples

  • A 'primary' and 'secondary' button in a row to progress through a multi-step form.
design-guide-button-row-example
  • A 'destructive' and 'secondary' button in a row to confirm and cancel a contact deletion.
buttonrow-example-cancel-delete-contact

Guidelines

  • DO: include a secondary button with a destructive button to allow users to cancel the action.
  • DO: pair primary and secondary buttons to indicate hierarchy of actions.
  • DON’T: use multiples of the same button type in a row. For example, don’t include more than one primary button in one row.
Last modified on November 2, 2026