App Bridge Ui

UiTitleBar

Admin page title bar with action buttons. Wraps the App Bridge <ui-title-bar> web component.

Usage

<script setup>
function handleCreate() { /* ... */ }
function handleExport() { /* ... */ }
</script>

<template>
  <ShUiTitleBar
    title="Products"
    :primary-action="{ label: 'Create product', onClick: handleCreate }"
    :actions="[
      { label: 'Export', onClick: handleExport },
    ]"
  />
</template>

With a breadcrumb (back button):

<template>
  <ShUiTitleBar
    title="Edit Product"
    :primary-action="{ label: 'Save', onClick: handleSave }"
    :breadcrumb="{ label: 'Products', onClick: () => navigateTo('/products') }"
  />
</template>

Props

PropTypeDefaultDescription
titlestringTitle displayed in the Admin bar
primaryActionTitleBarActionPrimary action button (highlighted)
breadcrumbOmit<TitleBarAction, 'disabled'>Back button / breadcrumb
actionsTitleBarAction[]Additional action buttons
interface TitleBarAction {
  label: string
  disabled?: boolean
  onClick: () => void
}

Notes

  • Unlike the raw <ui-title-bar> web component (which uses <button> children), <ShUiTitleBar> uses typed props with onClick callbacks for full TypeScript support.
  • Renders native <button> children from the action props internally.

App Bridge Element

Renders as <ui-title-bar>. See App Bridge TitleBar docs.

© 2026 KiriminAja. Polaris and Shopify are trademarks of Shopify Inc.

KiriminAja not affiliated with Shopify.