Migration guide · 15–30 minutes

Migrate from Braze to InstantPWA

Braze works, but most teams switch to InstantPWA for one-line install, unified iOS + Android + desktop support and simpler analytics without a per-subscriber bill.

Step by step

1
Audit your current setup
Open your site and note where Braze is loaded — usually a script tag in <head> or a plugin in your CMS. Screenshot the current install prompt and any push templates you rely on.
2
Install the InstantPWA snippet
Paste our 4 KB async snippet into your site head. It does not conflict with anything already loaded — you can run both in parallel while you test.
3
Match your branding
On the widget editor, click "Match my site". We scrape your live CSS and pull colours, fonts and border radius automatically. Tweak if needed.
4
Point analytics at the new events
InstantPWA fires install_shown, install_accepted, install_dismissed to window.dataLayer and to our dashboard. Update your GA4 or Segment event names to match.
5
Remove the old script
Once install rates match or beat Braze, delete the old script tag. Existing subscribers to Braze push stay subscribed to Braze — new subscribers will land in InstantPWA.

Gotchas

Braze subscriber lists do not transfer automatically. Web-push subscriptions are tied to the origin + service worker path, so migration is subscriber-by-subscriber as users return.
Run both prompts for a week before removing the old one, so you can compare accept rate on real traffic.
If your CSP blocks third-party scripts, add https://cdn.instantpwa.com to script-src before pasting the snippet.

FAQ

Will I lose my subscribers?

No, but they do not port over. Braze subscribers keep receiving Braze pushes until they unsubscribe. New visitors will subscribe via InstantPWA once you switch.

Can I run both at once?

Yes. Different SDKs, different service worker scopes. Use a 1–2 week overlap to A/B accept rates.

Do I need to re-verify the domain?

Yes — InstantPWA verifies the domain via a meta tag or DNS TXT record so we only serve widgets on sites you own.

Ready to try it?

The first 1,000 impressions are free. Paste one script tag and see accept rates in under an hour.

Other migrations