NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #3225 most downloaded on npm
An opinionated toast component for React.
Last release 1 months ago
09 Aug 2026
Ships unpredictably
gaps range from 9 days to 12 months
Some releases are documented
notes for 32 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
65 releases · first in 2023
One column per quarter.
Added support for custom aria labels by @hirotomoyamada in https://github.com/emilkowalski/sonner/pull/704
hotkey is an empty array by @hirotomoyamada in https://github.com/emilkowalski/sonner/pull/703Full Changelog: https://github.com/emilkowalski/sonner/compare/v2.0.7...v2.0.8
Sonner now supports multiple components, see more here.
Sonner now supports multiple <Toaster /> components, see more here.
Full Changelog: https://github.com/emilkowalski/sonner/compare/v2.0.6...v2.0.7
chore: upgrade pnpm to v9 to fix lockfileVersion mismatch by @metacode22 in https://github.com/emilkowalski/sonner/pull/658
Full Changelog: https://github.com/emilkowalski/sonner/compare/v2.0.5...v2.0.6
Main goal of this update is to fix css import.
Main goal of this update is to fix css import.
Full Changelog: https://github.com/emilkowalski/sonner/compare/v2.0.4...v2.0.5
chore: remove lift interaction by @emilkowalski in https://github.com/emilkowalski/sonner/pull/644
onDismiss fires correctly by @emilkowalski in https://github.com/emilkowalski/sonner/pull/645Full Changelog: https://github.com/emilkowalski/sonner/compare/v2.0.3...v2.0.4
chore: Don't show toast buffers when not expanded. by @emilkowalski in https://github.com/emilkowalski/sonner/pull/614
true by @emilkowalski in https://github.com/emilkowalski/sonner/pull/615Full Changelog: https://github.com/emilkowalski/sonner/compare/v2.0.2...v2.0.3
fix: isExtendedResult. Check if promiseData is an object and not a valid React Element by @diegotraid in https://github.com/emilkowalski/sonner/pull/5
Full Changelog: https://github.com/emilkowalski/sonner/compare/v2.0.1...v2.0.2
fix: flush sync error by @emilkowalski in https://github.com/emilkowalski/sonner/pull/586
Full Changelog: https://github.com/emilkowalski/sonner/compare/v2.0.0...v2.0.1
Mostly bug fixes, see more at https://sonner.emilkowal.ski/getting-started.
Mostly bug fixes, see more at https://sonner.emilkowal.ski/getting-started.
Full Changelog: https://github.com/emilkowalski/sonner/compare/v.2.0.0-beta.1...v2.0.0
chore: remove deprecated props by @emilkowalski in https://github.com/emilkowalski/sonner/pull/577
You can try the beta version by installing Sonner like this:
pnpm add sonner@2.0.0-beta.3
Full Changelog: https://github.com/emilkowalski/sonner/compare/v2.0.0-beta.2...v2.0.0-beta.3
You can try the beta version by installing Sonner like this:
You can try the beta version by installing Sonner like this:
pnpm add sonner@2.0.0-beta.2
Full Changelog: https://github.com/emilkowalski/sonner/compare/v.2.0.0-beta.1...v2.0.0-beta.2
No real breaking changes, mostly bug fixes. Run the command bellow if you want to try it out.
No real breaking changes, mostly bug fixes. Run the command bellow if you want to try it out.
pnpm add sonner@2.0.0-beta.1
I have also updated the styling docs with more information and the recommended method: https://sonner.emilkowal.ski/styling
Full Changelog: https://github.com/emilkowalski/sonner/compare/v1.7.3...v.2.0.0-beta.1
Nothing published for this version
Nothing published for this version
fix: swipe test by @emilkowalski in https://github.com/emilkowalski/sonner/pull/545
Full Changelog: https://github.com/emilkowalski/sonner/compare/v.1.7.2...v1.7.3
You can now customize offsets more easily & swipe to the right/left as well.
You can now customize offsets more easily & swipe to the right/left as well.
Full Changelog: https://github.com/emilkowalski/sonner/compare/v1.7.1...v.1.7.2
Updated docs: https://sonner.emilkowal.ski/getting-started
Updated docs: https://sonner.emilkowal.ski/getting-started
Full Changelog: https://github.com/emilkowalski/sonner/compare/1.7.0...v1.7.1
Majority of the updates are in https://github.com/emilkowalski/sonner/releases/tag/v1.6.1
Majority of the updates are in https://github.com/emilkowalski/sonner/releases/tag/v1.6.1
Full Changelog: https://github.com/emilkowalski/sonner/compare/v1.6.1...1.7.0
Thank you for using this library. This one contains a lot improvements, it also improves the animations a bit.
Thank you for using this library. This one contains a lot improvements, it also improves the animations a bit.
I released 1.6.0 and 1.6.1 right after, because I didn't build the package properly. You should use 1.6.1.
rtl by @zaaakher in https://github.com/emilkowalski/sonner/pull/453toast.promise by @ajmnz in https://github.com/emilkowalski/sonner/pull/462Toaster by @freshgiammi in https://github.com/emilkowalski/sonner/pull/491Full Changelog: https://github.com/emilkowalski/sonner/compare/v.1.5.0...v1.6.1
baa9bf7
Thank you for using this library. This one contains a lot improvements, it also improves the animations a bit.
I released 1.6.0 and 1.6.1 right after, because I didn't build the package properly. You should use 1.6.1.
Allow dismissing toasts with id = 0 by @MrFlashAccount in #442
fix toast timer by @emilkowalski in #458
fix: add "main" entry to package.json by @adamhenson in #457
fix: missing exported types by @alex-mcgovern in #459
Fix dependency array by @emilkowalski in #461
fix: reverse left position on mobile rtl by @zaaakher in #453
Allow awaiting toast.promise by @ajmnz in #462
feat: add support for custom close icon by @alexandernanberg in #481
update API reference for toast() by @plbstl in #471
fix: allow React.js v19 in peerDependencies by @theoludwig in #493
feat: allow ref forwarding for Toaster by @freshgiammi in #491
fix: support dark mode for safari < 14 using matchMedia().addListener by @yunsteel in #495
feat: support show react element from react server function by @himself65 in #492
Include styles.css in dist by @kevlened in #446
fix: implement loader class from config by @joewinger in #489
fix: remove repeat effect hook to resolve mix up by @Tzyito in #392
Fix inability to prevent toast from closing on action button click by @iuriiiurevich in #484
fix: incorrect stacking by @emilkowalski in #499
chore: remove templates by @emilkowalski in #500
fix: incorrect timer on hover by @emilkowalski in #501
feat: allow to pass custom elements to title and description by @emilkowalski in #502
fix: turn section into live region #306 by @tricinel in #436
docs: remove important property from docs by @emilkowalski in #503
fix: background for close button by @emilkowalski in #504
feat: improve swiping by @emilkowalski in #505
feat: lift the toasts when hoevered for a better feel by @emilkowalski in #506
@MrFlashAccount made their first contribution in #442
@adamhenson made their first contribution in #457
@alex-mcgovern made their first contribution in #459
@alexandernanberg made their first contribution in #481
@plbstl made their first contribution in #471
@theoludwig made their first contribution in #493
@freshgiammi made their first contribution in #491
@yunsteel made their first contribution in #495
@kevlened made their first contribution in #446
@joewinger made their first contribution in #489
@Tzyito made their first contribution in #392
@iuriiiurevich made their first contribution in #484
@tricinel made their first contribution in #436
Full Changelog : v.1.5.0...v1.6.1
tricinel, adamhenson, and 15 other contributors
Nothing published for this version
3x smaller bundle size and other improvements, thank you for all the contributions!
3x smaller bundle size and other improvements, thank you for all the contributions!
ReactNode descriptions by @peetzweg in https://github.com/emilkowalski/sonner/pull/387toast.promise results by @ajmnz in https://github.com/emilkowalski/sonner/pull/389Full Changelog: https://github.com/emilkowalski/sonner/compare/v.1.4.41...v.1.5.0
[Docs]: Render toast on page load by @luis-viegas in https://github.com/emilkowalski/sonner/pull/363
--mobile-offset by @atsixian in https://github.com/emilkowalski/sonner/pull/371Toaster.duration is set to Infinity by @atsixian in https://github.com/emilkowalski/sonner/pull/373Toaster.gap doesn't work by @atsixian in https://github.com/emilkowalski/sonner/pull/375Full Changelog: https://github.com/emilkowalski/sonner/compare/v1.4.3...v.1.4.41
Nothing published for this version
Nothing published for this version
Nothing published for this version
Replace icons in a promise correctly by @emilkowalski in https://github.com/emilkowalski/sonner/pull/352
Full Changelog: https://github.com/emilkowalski/sonner/compare/v1.4.1...v1.4.3
Nothing published for this version
You can now customize icons from , this was announced in the previous version, but was reverted afterwards. Sorry about that!
You can now customize icons from <Toaster />, this was announced in the previous version, but was reverted afterwards. Sorry about that!
Full Changelog: https://github.com/emilkowalski/sonner/compare/v1.4.0...v1.4.1
Use bunchee as bundler by @huozhi in https://github.com/emilkowalski/sonner/pull/276
description support function in promise by @kahosan in https://github.com/emilkowalski/sonner/pull/279icons prop to <Toaster /> by @amirhhashemi in https://github.com/emilkowalski/sonner/pull/270<li> offest when using different positions by @mmalomo in https://github.com/emilkowalski/sonner/pull/314Full Changelog: https://github.com/emilkowalski/sonner/compare/v1.3.0...v1.4.0
Nothing published for this version
Remove unstyled prop from Hero toast by @IgorKowalczyk in https://github.com/emilkowalski/sonner/pull/241
loadingIcon by @emilkowalski in https://github.com/emilkowalski/sonner/pull/268Full Changelog: https://github.com/emilkowalski/sonner/compare/v1.2.4...v1.3.0
Props for toast container and close button aria-labels by @rodymolenaar in https://github.com/emilkowalski/sonner/pull/239
Full Changelog: https://github.com/emilkowalski/sonner/compare/v1.2.3...v1.2.4
Remove unnecessary console.log by @Contreux in https://github.com/emilkowalski/sonner/pull/233
Full Changelog: https://github.com/emilkowalski/sonner/compare/v1.2.1...v1.2.3
Nothing published for this version
Styling customization, especially with Tailwind should be much easier now. I created a new page in the documentation with more details - https://sonne
Styling customization, especially with Tailwind should be much easier now. I created a new page in the documentation with more details - https://sonner.emilkowal.ski/styling.
Full Changelog: https://github.com/emilkowalski/sonner/compare/v1.2.0...v1.2.1
Close custom toasts by @emilkowalski in https://github.com/emilkowalski/sonner/pull/218
Full Changelog: https://github.com/emilkowalski/sonner/compare/v1.1.0...v1.2.0
Add dark mode to docs by @emilkowalski in https://github.com/emilkowalski/sonner/pull/150
PromiseData partial in toast.promise by @ajmnz in https://github.com/emilkowalski/sonner/pull/164Full Changelog: https://github.com/emilkowalski/sonner/compare/v1.0.0...v1.1.0
Nothing published for this version
Nothing published for this version
Nothing published for this version
Account for velocity when swiping by @emilkowalski in https://github.com/emilkowalski/sonner/pull/123
Full Changelog: https://github.com/emilkowalski/sonner/compare/v0.7.0...v1.0.0
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Fix initial theme by @emilkowalski in https://github.com/emilkowalski/sonner/pull/99
Full Changelog: https://github.com/emilkowalski/sonner/compare/v0.6.0...v0.7.0
Nothing published for this version
Nothing published for this version
Update preview video URL by @vallezw in https://github.com/emilkowalski/sonner/pull/88
Full Changelog: https://github.com/emilkowalski/sonner/compare/v0.5.0...v0.6.0
chore: add threshold to start swipe by @joaom00 in https://github.com/emilkowalski/sonner/pull/72
Full Changelog: https://github.com/emilkowalski/sonner/compare/v0.4.0...v0.5.0
Add custom id by @emilkowalski in https://github.com/emilkowalski/sonner/pull/51
Full Changelog: https://github.com/emilkowalski/sonner/compare/v0.3.0...v0.4.0
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Adjust offset types by @emilkowalski in https://github.com/emilkowalski/sonner/pull/31
Full Changelog: https://github.com/emilkowalski/sonner/compare/v0.2.0...v0.3.0
Fix batch updates by @emilkowalski in #28
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →