Button group

Button group displays multiple related actions stacked or in a horizontal row to help with arrangement and spacing.

Use when you have multiple buttons to space them out evenly.

import {ButtonGroup, Button} from '@shopify/polaris';
import React from 'react';

function ButtonGroupExample() {
  return (
      <Button primary>Save</Button>


Want to help make this feature better? Please share your feedback.

interface ButtonGroupProps
spacing?'extraTight' | 'tight' | 'loose'

Determines the space between button group items.


Join buttons as segmented group.


Buttons will stretch/shrink to occupy the full width.


Remove top left and right border radius.


Button components.

Best practices

Button groups should:

  • Only use buttons that follow the best practices outlined in the button component
  • Group together calls to action that have a relationship
  • Be used with consideration that too many calls to action can cause merchants to be unsure of what to do next
  • Be thoughtful about how multiple buttons will look and work on small screens
  • Only be used in groups of up to six buttons if the buttons contain an icon with no text

Content guidelines

Button groups should follow the content guidelines for buttons.