Widgets

Gauge charts in email, connected to your metrics.

A semicircular gauge with a needle and tick marks for scores, usage, or quota attainment. Supply a current value and target through URL parameters, or connect a public JSON source. DynaMail uses those values when rendering the image; email clients may keep their own cached copy.

Gauge chart widget for email rendered by DynaMail: a speedometer-style dial with a needle and tick marks

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?current=72&target=100" width="300" height="200" 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

  • Account usage — show customers how much of their plan they have used
  • Score recaps — NPS, health scores, or performance ratings at a glance
  • Sales and quota emails — attainment against target, per rep
  • Fitness and habit digests — weekly effort against a personal goal

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.

?current=…The value the needle points at (required) — merge-tag friendly
?target=…The maximum the gauge sweeps toward (required)
?v_name=…Override any {v_name} text placeholder in your design

Frequently asked questions

How do I put a gauge chart in an email?

Design the gauge in the DynaMail dashboard, then paste its image URL into an <img> tag. It behaves like any other image in your template — no code, no plugin, works in any email service provider.

What can the gauge show?

Any current value against a target: plan usage, an NPS or health score, quota attainment, or a rating. Values can come from the URL or a public JSON source. The first image request after the source refresh window expires attempts a new read, and URL values take precedence. Email clients may reuse a previously fetched image.

Can the needle be personalized per recipient?

Yes. Pass ?current= and ?target= in the image URL using your email platform's merge tags, and each recipient sees a gauge rendered from their own numbers.

Will it render in Outlook?

Yes — the widget is a standard image, so it displays wherever images do. The URL extension requests the format (render.gif, render.png, render.webp, render.apng); depending on the design, an animated widget may be served in a compatible animated format even when a static extension is requested. Classic Outlook for Windows freezes animations on their first frame, so a gauge design without an intro animation is the safest choice there.