Simplify your stack and build anything. Or everything.
Build tomorrow’s web with a modern solution you truly own.
Code-based nature means you can build on top of it to power anything.
It’s time to take back your content infrastructure.

Banner

The Banner component displays a short message that needs more emphasis than surrounding content. Use its type to communicate the purpose of the message.

Import

Inside a Payload Admin Panel Custom Component:

1
import { Banner } from '@payloadcms/ui'

You can also import the component directly:

1
import { Banner } from '@payloadcms/ui/elements/Banner'

Basic usage

Loading component example…

Types

Use brand for product context, success to confirm an action, warning to flag a risk, and danger when something failed. Use the default type for neutral messages.

Loading component example…

Keep banner copy concise and include the next action when the user must resolve something.

Accessibility

  • Use text that communicates the message without relying on color alone.
  • Include an icon only when it reinforces the meaning of the message.
  • Keep actionable banners keyboard accessible and give their action a clear purpose.

Common props

These are the props most commonly used with this component. See its exported types in @payloadcms/ui for the complete list.

Prop

Type

Default

Description

children

ReactNode

—

Message displayed inside the banner.

type

'default' | 'brand' | 'success' | 'warning' | 'danger'

'default'

Sets the message style.

icon

ReactNode

—

Displays an icon beside the message.

alignIcon

'left' | 'right'

'left'

Positions the icon.

onClick

(event: MouseEvent) => void

—

Makes the banner actionable.

to

string

—

Makes the banner navigate to the given URL.

Was this page helpful?

Next

Button