Toaster props

Every prop the Toaster accepts, with its type and default.

TSX
<Toaster position="top-center" visibleToasts={3} />

Placement

positionToastPositionDefault: 'top-center'; 'bottom-center' with the Material preset
For toasts that do not set one
offsetnumberDefault: 16
Distance from the screen edge, added to the safe area
gapnumberDefault: 14
Space between toasts
reverseOrderbooleanDefault: false
Newest toast at the far end of the stack
toasterIdstringDefault: 'default'
Run several independent Toasters
ContainerComponentcomponentDefault: none
Render inside another component, such as FullWindowOverlay
containerStyleViewStyleDefault: none
The full-screen container

Queue

visibleToastsnumberDefault: 3
Toasts shown at once per position
maxPendingnumberDefault: 10
Toasts that wait beyond the visible ones
dropPolicy'oldest' or 'newest'Default: 'oldest'
Which toast to drop when the queue is full
pausedbooleanDefault: false
Freeze every timer
stackedbooleanDefault: false
Collapse each stack behind its newest toast; press to fan it out

Defaults and appearance

preset'auto', 'glass' or 'material'Default: 'auto'
The look to start from: a Material 3 snackbar on Android, the glass pill elsewhere; see Customising
animation'hot', 'slide', 'fade', 'pop' or 'none'Default: 'hot'
How toasts come and go
icons{ success?, error?, info?, warning?, loading?, blank?, close? }Default: none
Icons in place of the built-in glyphs
blur{ component, props? }Default: none
A blur view, such as expo-blur’s, for Android and iOS before 26; see Customising
toastOptionsToastOptions, plus per-type bucketsDefault: none
Defaults for every toast in this Toaster
themepartial theme tokensDefault: none
Token overrides
colorScheme'light' or 'dark'Default: the system’s
Force light or dark tokens
glassboolean or GlassConfigDefault: true
false draws the opaque surface everywhere
panThresholdnumberDefault: 72
Sideways swipe distance that dismisses; 0 turns swiping off
hapticsboolean, or a map from type to ToastHapticDefault: true
true plays each type’s default (success, error, warning); a map picks per type: { success: 'medium', info: 'light' }
announcebooleanDefault: true
false keeps screen readers from hearing this Toaster’s toasts, for a preview or a demo that plays on its own
children({ toast, theme }) => ReactNodeDefault: none
Draw each toast yourself; see Custom rendering

GlassConfig

FieldTypeDefault
style'regular' or 'clear''regular'The Liquid Glass variant
tintColorstringnoneTint over the glass
interactivebooleanfalseThe glass reacts to touch
containerizebooleantruePut a stack in one glass container, so neighbours blend
containerSpacingnumberthe gapDistance at which neighbours blend

gutter and toastLimit still work as deprecated names for gap and visibleToasts.

Last updated on Oct 26, 2026

Edit on GitHub