Weather
A weather widget is a live current-conditions and forecast display you embed in a page or dashboard. WidgetCraft's Weather widget auto-detects your location via the browser Geolocation API, fetches data from Open-Meteo with no API key required, and embeds in Notion, Obsidian, or any iframe-capable website.
WidgetCraft's Weather widget shows current temperature, feels-like, humidity, wind speed, a weather condition icon, and a configurable multi-day forecast — up to 7 days by default. Location detection is fully automatic: the widget requests browser geolocation permission, then reverse-geocodes the coordinates using Nominatim (OpenStreetMap) to display a readable city name. If geolocation is denied, it falls back to IP-based location via our own /api/geo endpoint (reads Vercel's edge-network geo — no third-party rate limits). You can also pin a specific location by adding `?lat=` and `?lon=` to the embed URL — useful for team dashboards where you want a fixed city rather than each viewer's own position. Temperature units are switchable between Celsius and Fahrenheit via `?units=fahrenheit`. Open-Meteo is a free, open-source weather API with no account required and coverage for every location on earth, making this widget genuinely zero-setup for most users. Embed it in a Notion workspace header to start every day with a glance at conditions outside, or use it in an Obsidian daily note template so the weather is captured automatically.
Questions, answered.
How does the weather widget detect my location?
The widget calls the browser's built-in Geolocation API, which prompts you to allow or deny. If you allow it, coordinates are sent to Open-Meteo for the forecast and to Nominatim for a city name. If you deny, it falls back to IP-based location via WidgetCraft's own /api/geo endpoint — which reads Vercel's edge geo headers so there are no third-party rate limits.
Which weather provider does it use?
It uses Open-Meteo, a free open-source weather API that covers all locations worldwide. No API key or account is needed — the widget works out of the box.
Can I choose Celsius or Fahrenheit?
Yes. Add `?units=fahrenheit` to the embed URL to switch to °F and mph. Leave it off (or set `?units=celsius`) for °C and km/h. The builder also exposes this as a dropdown.
Can I pin the widget to a specific city instead of auto-detecting?
Yes. Add `?lat=48.85&lon=2.35` (or any coordinates) to the URL to lock the widget to that location. Add `?city=Paris` alongside it if you want to override the displayed city name.
How many forecast days does it show?
The default is 5 days. Add `?days=7` to show up to 7 days, or `?days=3` for a more compact view. The builder exposes a slider for this.
Does the weather widget require an API key?
No. Open-Meteo's free tier handles all traffic for embedded widgets without any authentication. You don't need to create an account or generate a key.
How often does the weather data refresh?
By default the widget fetches fresh data when the iframe loads and then on the interval set in the builder. Open-Meteo updates its forecasts hourly, so polling more frequently than once every 10–15 minutes yields no new data.