Add support for multiple toasters

[timolins]

This PR implements the ability to have multiple toasters at once.

// Create a toaster with a custom id
<Toaster id="custom-toaster" />;

// Create a toast within the new toaster
toast.success('Nice toast!', {
  toasterId: 'custom-toaster',
});

<Toaster /> // Default toaster
<div>
  <Toaster
    toasterId="area1"
    containerStyle={{ position: 'absolute' }}
  />
</div>
<div>
  <Toaster
    toasterId="area2"
    containerStyle={{ position: 'absolute' }}
  />
</div>

Related issue

Closes #158

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
react-hot-toast	Ready	Preview	Comment	Aug 15, 2025 3:34pm

[github-actions]

size-limit report 📦

Path	Size
dist/index.js	5.19 KB (+3.99% 🔺)
dist/index.mjs	4.89 KB (+4.36% 🔺)
headless/index.js	2.05 KB (+10.36% 🔺)
headless/index.mjs	1.77 KB (+12.44% 🔺)

[GitScorz]

Is this ready? I really need this, but the latest version is still 2.5.1.

[timolins]

I just published v2.6.0-beta.0, which adds support for multiple toasters. You can give it a try with npm i react-hot-toast@beta. Testers and feedback are much appreciated.

[maxratajczak]

I just published v2.6.0-beta.0, which adds support for multiple toasters. You can give it a try with npm i react-hot-toast@beta. Testers and feedback are much appreciated.

So far I've been testing/using the beta and it's working great 👍 Thanks!

[GitScorz]

I just published v2.6.0-beta.0, which adds support for multiple toasters. You can give it a try with npm i react-hot-toast@beta. Testers and feedback are much appreciated.

So far I've been testing/using the beta and it's working great 👍 Thanks!

Yes me too. Working perfectly.

[barrymay]

Been playing around with the multi-toaster feature in beta, works great! Looking forward to using it in non-beta. Thanks! :D

[georgiosApo]

Hey @timolins! Any chance this will be merged anytime soon? 😇
Cheers!

[alexdawes]

I've also been using this recently, and it works perfectly - a really nice addition!

Any chance this can be merged and released some time soon?

Thanks!

[amanzanero]

@timolins, Thanks for this! Curious if there's any blocker for having this merged? Also, it looks like this beta has a substantial number of weekly downloads!