Skip to main content
CONNECT GUIDES

Send WeatherX alerts to your screen

One click from the button in your email. Your browser asks; you press Allow. No app, no account anywhere, and it is free.

All connect guides

This is the one with nothing to install and no account anywhere. You press a link, your browser asks whether we may show you notifications, you say yes, and from then on a weather warning appears on your screen — on the desktop, or on the phone home screen. No app, no extension, no team chat account, and it is free.

Your emailpress Turn on alertsYour browserpress AllowWeatherXwatches the placeevery alert from then on, with no further work

The steps

  1. In the WeatherX email, press Connect Web push. Do it on the device you want the alerts on — that is the one that will show them.

  2. A WeatherX page opens with one button. Press Turn on alerts.

  3. Your browser asks. Press Allow.

  4. The page says the alerts are on and names your place. That line is the confirmation.

nowcasting.weatherxanalytics.comwants to show notificationsAllowBlock
What your browser asks. Every browser draws this its own way; they all ask the same thing.

Which browsers can do it

  • Chrome and Edge — on Windows, macOS, Linux and Android.
  • Firefox — on Windows, macOS, Linux and Android.
  • Safari — on macOS. On an iPhone or an iPad you must first add the page to the home screen and open it from there; Safari does not offer notifications to an ordinary tab.

If the page says your browser cannot show web alerts, it is not guessing — it asked, and the browser said no. Your email lists the other ways to receive the same alerts.

What arrives, and when

We look at your place every ten minutes. You get one message when weather is coming or has started, and one when it has passed. A quiet week is a quiet channel — nothing arrives to say that nothing is happening.

WeatherX

STOP — lightning — Acme depot

The lightning is at the place now.

This is measured at the place, not a forecast.

How strong: high (level 3 on our scale).

We measured this at 14:10 UTC.

Stop these alerts: https://weatherx.earth/guide/webpush/

The first line is the decision: STOP means it is at the place now or within twenty minutes, PREPARE means it is coming, ALL CLEAR means it has passed.

The last line of every message points back at this page. It is a link to a manual and not a switch: opening it changes nothing, so an alert that is forwarded, quoted or read by a spam filter carries nothing anybody can act on.

What changes on our side

  • The place named in your email gets one destination: this browser, on this device.
  • Alerts for that place go there from the next ten-minute cycle. Nothing else about your account moves.
  • Your API key is not touched. It never travels in any of these links.
  • You can have more than one destination on a place. Add another and both receive every alert.

The honest limits

Web push belongs to one browser on one device. It is not an account and it does not follow you.

  • Turning it on in Chrome on your laptop does not turn it on in Firefox, and not on your phone. Open the same link on each one you want.
  • If you clear this site’s data — clearing cookies and site data, or a browser set to clear on exit — the alerts stop. Nothing tells us, and nothing tells you.
  • A private or incognito window forgets everything when it closes, so it is not the place to turn these on.
  • The device shows the alert when it is next awake and online. A phone that was off all night does not show last night’s warnings: we ask the push service to drop anything older than ten minutes, because a warning about weather that has already happened is worse than none.
  • Your browser can also replace the subscription on its own. Then the alerts stop and we switch that destination off at the first message we cannot deliver. Open the link again to turn it back on.

If the alerts go quiet and you did not stop them, open the link again — or write to support@weatherx.earth and ask for a new one.

How to stop it

You can stop it yourself, in the browser, without telling anybody: open the site settings for this page — the icon at the left of the address bar in most browsers — and set notifications to Block. It stops at once.

Clearing this site’s data does the same thing.

That stops this browser. To stop the alerts everywhere, take the destination off our side as well — below.

How to stop everything, without asking anybody

Your WeatherX email carries a Stop link at the bottom. Open it, and press the button on the page it shows. It stops every alert for that place and turns off every destination on it, at any hour. It needs no key and no reply.

Write to support@weatherx.earth, and ask us to take one destination off and leave the rest running.

That is the whole job

If you have connected the destination and you know how to stop it, you are done. You can stop reading here.

Everything below this line is for a developer — somebody who makes calls to our API from a program. It is a different way to do some of the same things, and one thing more. Nobody needs it to receive alerts.

Everything here needs your API key

Send it as an X-API-Key header. It is the key from your welcome message, and it never travels in a connect link — the two are separate on purpose.

Send yourself a real alert, now

You do not have to wait for weather. One call sends a real alert through the real senders:

POST /portal/sites/<place id>/test
X-API-Key: wx_live_…

It arrives as light rain half an hour away, and it says on its face that it is a test — in the first line of the message — so nobody can mistake it for weather. One a minute, twenty a day.

It goes to every destination on that place, not only to the one this page is about. If the place already writes into your team's chat, your team sees the test too. Say so first, or test on a place that has only one destination on it.

Take one destination off, and leave the rest

The Stop link above turns off everything at once. This takes off one and leaves the place watched. Ask for the list, then delete the one you mean:

GET /portal/sites/<place id>/channels
DELETE /portal/channels/<id>
X-API-Key: wx_live_…

Everything else on that place carries on receiving.

If the Web push link has been used, or is older than seven days, or the message it came in was deleted, mint another:

POST /portal/sites/<place id>/connect/webpush
X-API-Key: wx_live_…

{"kind": "webpush", "url": "https://…", "expires_at": "…"}

Open the url in a browser and it behaves exactly like the button in your message — the key stays in the header and never travels in the link. Asking again for the same place and the same destination replaces the live link rather than adding a second one, so the newest one you were given is the one that works.

The message as fields, not sentences

This destination receives the alert written out as sentences, because a person reads it. A program usually wants the numbers instead — how far away, which direction, how far ahead the forecast was. That is a second destination kind, and it has its own page: alerts to your own server. A place can carry both at once.

The steps on this page were checked on . The example message is not a copy — it is drawn by the same code that writes your alerts, so it is current on every visit. Menus in other companies' products change; if this page no longer matches what you see, write to support@weatherx.earth and tell us. A person reads it.

This page holds no key, sets no cookie and runs nothing that follows you.