Widgets

Show the daylight window in email.

Display sunrise, sunset, and daylight hours for a selected location. A city or coordinate pair in the image URL overrides the saved location; date selects a YYYY-MM-DD weather request. DynaMail reads Open-Meteo data and caches weather results for one hour. Email clients may reuse an earlier image.

Daylight card for New York showing 14 h 15 m of daylight between 6:15 AM sunrise and 8:30 PM sunset, with a now marker on a 24-hour bar

A real render produced by DynaMail’s image pipeline.

Create a free account

Free while in beta · No credit card required

How it works

Every DynaMail widget is a plain image URL. Design it in the dashboard, then paste the URL into an <img> tag — or your email editor’s image block — like this:

Example embed snippet

<img src="https://img.dynamail.io/widgets/YOUR-WIDGET-ID/render.png?locationQuery=Chicago" width="360" height="190" alt="" />

YOUR-WIDGET-ID is a placeholder — every widget you create gets its own id. The file extension requests the output format — gif, apng, webp, or png. Depending on the design, an animated widget may be served in an animated format even when a static extension is requested.

DynaMail renders when the image is requested and briefly caches the result. Email clients and their image proxies can also cache images, so a later open may reuse a previous response. No script, no custom HTML, nothing for your email platform to strip out.

What it’s for

  • Outdoor event updates — show sunrise and sunset
  • Travel emails — display daylight at a destination
  • Local newsletters — add the daylight window for a city

Personalize it in the URL

The data behind the widget — its values, chart points, and text placeholders — can come from the URL. Append query parameters, or your email platform’s merge tags, and each recipient’s open renders from their own data.

?locationQuery=…A city, postcode, or address; overrides the saved location
?latitude=…Latitude; use with longitude to override the saved location
?longitude=…Longitude; use with latitude to override the saved location
?date=…Request a date in YYYY-MM-DD format for sunrise and sunset data

Frequently asked questions

How is the daylight location chosen?

A URL locationQuery takes priority over a valid URL latitude and longitude pair, then the saved location. A widget saved in IP mode can use the image request’s client IP.

Can I choose the date?

Yes. Set date in YYYY-MM-DD format. The handler passes it to the weather request; the provider must return usable data for that date.

Where do daylight times come from?

DynaMail reads sunrise and sunset from Open-Meteo weather data and caches results for one hour. Email clients may reuse an earlier image. Forecasts are estimates for general information and may differ at your location or time. Do not rely on them alone for safety, aviation, marine travel, or emergencies; consult official weather services and authorities.

What if daylight data is unavailable?

A production render shows “Weather data unavailable” when the weather fetch returns no data. Editor previews may use sample weather.