Skip to main content

Introducing the DealSize widget docs

· 2 min read
DealSize Team
DealSize Team
Widget engineering at DealSize

Welcome to the new home of DealSize documentation.

If you run a trading site, a broker portal, or a finance blog, you can now embed DealSize's Economic Calendar, News, and Trading Signals widgets with a single script tag. This site documents everything you need to do that well.

What you'll find here​

  • Getting started: the one-page overview of how embedding works.
  • Per-widget guides: copy-paste embed snippets, common recipes, and a full parameter reference for the Calendar, News, and Trading Signals widgets.
  • Interactive playgrounds: configure each widget live in your browser and copy the exact embed code, no sign-up required.
  • Attribution: how to make sure sign-ups from your site are credited to you.

Every widget is one script tag​

There is no SDK, no backend, and no build step. The loader script replaces itself with a container holding an iframe pointed at the widget, and every data-* attribute you set, apart from the sizing and container options, is forwarded to the widget as configuration. That works the same way in plain HTML, React, Vue, or any CMS that lets you paste a script tag.

Widgets ship in 10 languages, with right-to-left support for Arabic, and each one exposes a small set of semantic color parameters so it can match your brand. Each widget's Parameters page lists every option it accepts.

Read the attribution page before you go live​

One point is worth pulling out of the reference, because it is the most common integration mistake: always pass data-utm-source where it is supported.

Sign-ups that originate from your embed are credited to you through utm_source, and that value has to be passed explicitly. Browsers routinely strip or truncate the referrer an iframe sees, so it cannot be inferred from where the widget is running. Unsupported parameters are ignored harmlessly, so passing it is always safe. Attribution covers the details, including which widgets support the parameter.

What's next​

We'll use this blog for widget changelogs, new parameters, and integration tips. Watch this space.