Toaster props
Every prop the Toaster accepts, with its type and default.
<Toaster position="top-center" visibleToasts={3} />Placement
positionToastPositionFor toasts that do not set one
offsetnumberDistance from the screen edge, added to the safe area
gapnumberSpace between toasts
reverseOrderbooleanNewest toast at the far end of the stack
toasterIdstringRun several independent Toasters
ContainerComponentcomponentRender inside another component, such as
FullWindowOverlaycontainerStyleViewStyleThe full-screen container
Queue
visibleToastsnumberToasts shown at once per position
maxPendingnumberToasts that wait beyond the visible ones
dropPolicy'oldest' or 'newest'Which toast to drop when the queue is full
pausedbooleanFreeze every timer
stackedbooleanCollapse each stack behind its newest toast; press to fan it out
Defaults and appearance
preset'auto', 'glass' or 'material'The look to start from: a Material 3 snackbar on Android, the glass pill elsewhere; see Customising
animation'hot', 'slide', 'fade', 'pop' or 'none'How toasts come and go
icons{ success?, error?, info?, warning?, loading?, blank?, close? }Icons in place of the built-in glyphs
blur{ component, props? }A blur view, such as expo-blur’s, for Android and iOS before 26; see Customising
toastOptionsToastOptions, plus per-type bucketsDefaults for every toast in this Toaster
themepartial theme tokensToken overrides
colorScheme'light' or 'dark'Force light or dark tokens
glassboolean or GlassConfigfalse draws the opaque surface everywherepanThresholdnumberSideways swipe distance that dismisses;
0 turns swiping offhapticsboolean, or a map from type to ToastHaptictrue plays each type’s default (success, error, warning); a map picks per type: { success: 'medium', info: 'light' }announcebooleanfalse keeps screen readers from hearing this Toaster’s toasts, for a preview or a demo that plays on its ownchildren({ toast, theme }) => ReactNodeDraw each toast yourself; see Custom rendering
GlassConfig
| Field | Type | Default | |
|---|---|---|---|
style | 'regular' or 'clear' | 'regular' | The Liquid Glass variant |
tintColor | string | none | Tint over the glass |
interactive | boolean | false | The glass reacts to touch |
containerize | boolean | true | Put a stack in one glass container, so neighbours blend |
containerSpacing | number | the gap | Distance at which neighbours blend |
gutter and toastLimit still work as deprecated names for gap and
visibleToasts.
What did you think of this content?
Glad it helped. A star on GitHub is how other people find it.
Thank you. The issue that just opened goes straight to the maintainer; say what was missing and the page gets fixed.