Skip to main content

ActionBar

Allows you to define custom action bar items for any page in the dashboard, which is the top bar that normally contains the main call-to-action buttons such as "update" or "create".

This API also allows you to specify dropdown menu items, which when defined, will appear in a context menu to the very right of the ActionBar.

Signature

pageId

propertystring

The ID of the page where the action bar item should be displayed.

component

propertyReact.FunctionComponent<{ context: PageContextValue }>

A React component that will be rendered in the action bar. Typically, you would use the default Shadcn <Button> component.

type

property'button' | 'dropdown'
Default:'button'

The type of action bar item to display. Defaults to button. The 'dropdown' type is used to display the action bar item as a dropdown menu item.

When using the dropdown type, use a suitable dropdown item component, such as:

Tsx

requiresPermission

propertystring | string[]

Any permissions that are required to display this action bar item.

id

propertystringv3.5.2

A unique identifier for this action bar item. This is required if you want other extensions to be able to position their items relative to this one.

position

propertyActionBarItemPositionv3.5.2

Position this item relative to another action bar item. The itemId should match the id of an existing action bar item (either a built-in item or one added by another extension).

  • 'before': Place this item before the target item
  • 'after': Place this item after the target item
  • 'replace': Replace the target item entirely with this item

The relative position of an ActionBar item. This is determined by finding an existing action bar item by its id, and then specifying whether your custom item should come before, after, or completely replace that item.

Signature

itemId

propertystring

order

property'before' | 'after' | 'replace'
Was this chapter helpful?
Report Issue
Edited Feb 23, 2026ยทEdit this page