Legacy stack

This is the legacy version of the Stack component which is in the process of being updated to a more flexible and composable API. Use to lay out a horizontal row of components or to achieve no-fuss vertical centering. A stack is made of flexible items that wrap each of the stack’s children. Options provide control of the wrapping, spacing, and relative size of the items in the stack.


This component is no longer supported. The new BlockStack component can be used in combination with the new layout primitives to achieve similar results to LegacyStack. Learn more about our component lifecycles.

Legacy stack component examples

Use to quickly lay out a horizontal row of components and maintain their relative sizes. On small screens, children rows wrap down to additional rows as needed.

import {LegacyStack, Badge} from '@shopify/polaris';
import React from 'react';

function LegacyStackExample() {
  return (

Best practices

Stacks should:

  • Be used for small-scale layout tasks when you want a row of components that should wrap on small screen widths
  • Be used to vertically center two elements
  • Not be used for complex or unique arrangements of components
  • Not be used for large-scale page layout

Stack item

The stack component will treat multiple elements wrapped in a stack item component as one item. By default, each individual element is treated as one stack item. Use the fill prop on a single stack item component to make it fill the rest of the available horizontal space. See the “Stack where a single item fills the remaining space” example.

Stack item properties

fillbooleanFill the available horizontal space in the stack with the itemfalse
childrenanyElements to display inside stack item


The stack component is for alignment only and doesn’t provide any structural information for assistive technologies. To convey relationships between specific items, consider using the list component.

    On this page