NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm
npm, #3225 most downloaded on npm
An opinionated toast component for React.
Latest stable
2.0.8
Last release 3 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
Drag across the ruler to compare, or tap a release to open it.
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
Your coding agent can read these notes before it upgrades. Set up the MCP server →
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
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
One column per quarter.