Widgets

UV conditions in your email.

Show the UV index, category, and selected weather details for a location. A URL city or coordinate pair can override the saved location. DynaMail reads Open-Meteo weather data for new renders and caches weather results for one hour; email clients may reuse an earlier image.

UV index card for New York showing a reading of 7, rated High, on a color scale with sun advice

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="320" height="220" 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 emails — show the local UV index
  • Travel updates — include the UV category at a destination
  • Local newsletters — add a UV reading for a selected 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
?temperatureUnit=…Display temperature in fahrenheit or celsius when the design shows it

Frequently asked questions

How is the UV 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.

Where does the UV reading come from?

DynaMail reads 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 weather data is unavailable?

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