Migrate to the Polaris menu component

The Polaris menu component displays a list of actions in a popover triggered by a button. It replaces the previous Menu component and is available as <s-menu> in API versions 2025-10 and newer.

The biggest change is how the menu is wired to its trigger. The previous Menu was passed to a Button through the overlay prop. <s-menu> is a sibling element that's opened by a trigger button through commandFor, matching the pattern used for modals and other overlays.

import '@shopify/ui-extensions/preact';
import {render} from 'preact';

export default function extension() {
  render(<Extension />, document.body);
}

function Extension() {
  return (
    <>
      <s-button commandFor="order-actions-menu">Manage</s-button>
      <s-menu
        id="order-actions-menu"
        accessibilityLabel="Order actions"
      >
        <s-button onClick={() => console.log('Submit problem')}>
          Submit problem
        </s-button>
        <s-button href="https://shopify.com">Request return</s-button>
        <s-button tone="critical">Cancel order</s-button>
      </s-menu>
    </>
  );
}

import {
  Button,
  Menu,
  reactExtension,
} from '@shopify/ui-extensions-react/customer-account';

export default reactExtension(
  'customer-account.page.render',
  () => <Extension />,
);

function Extension() {
  return (
    <Button
      overlay={
        <Menu>
          <Button onPress={() => console.log('Submit problem')}>
            Submit problem
          </Button>
          <Button to="https://shopify.com">Request return</Button>
          <Button appearance="critical">Cancel order</Button>
        </Menu>
      }
    >
      Manage
    </Button>
  );
}

Anchor to Removed propertiesRemoved properties

Anchor to onOpen and onCloseonOpen and onClose

The previous Menu onOpen and onClose callbacks have been removed.

Anchor to Further guidanceFurther guidance

Anchor to Button changes inside the menuButton changes inside the menu

Menu items are now <s-button> elements. For the full list of prop changes, see Migrate to the Polaris button component.