Skip to content

Free widgets / Install guides

Widget documentation

Install an FXMacroData widget on any website.

Every widget installs the same way: copy one snippet, paste it where the widget should appear, publish. Pick your platform for exact steps, or use the options reference to tailor currencies, theme, language and time zone.

Cost Free with attribution API key Not needed Widgets 8 plus FX pair charts

How installation works

Step 1CopyChoose a widget and a theme, then copy the snippet or the direct widget address.
Step 2PastePaste it into an HTML, code or embed element on your page.
Step 3PublishThe widget loads official-source data, sizes itself and keeps itself up to date.

Choose your platform

Embed options reference

Options are attributes on the widget element. Only the widget type is required; everything else has a sensible default.

AttributeValuesWhat it does
data-fxmd-licenseUse the value generated by the widget builderPublic display token for your registered domain. Sign in and use Commercial Redistribution in the builder; never paste an API key here.
data-fxmd-widget-typeeconomic-calendar, release-countdown, latest-releases, central-bank-watch, policy-rates, inflation-heatmap, release-ticker, macro-scorecardWhich widget to render. Required for every widget except the FX pair charts.
data-fxmd-currenciesComma-separated codes, e.g. USD,EUR,GBP,JPYCurrencies to include. Defaults to the widget's own selection.
data-fxmd-themedark, light, transparent, autoColour scheme. auto follows each visitor's light or dark preference.
data-fxmd-limit1 to 12Requested rows. Free preview limits are enforced by the server, regardless of this value.
data-fxmd-importanceall, medium, highMinimum event importance for the calendar and the countdown.
data-fxmd-timezoneviewer, or an IANA zone such as Europe/LondonShow times in each visitor's local zone or a fixed zone. Defaults to UTC.
data-fxmd-langen, fr, es, pt, zh, ja, de, arWidget language. Defaults to the language of your page.
data-fxmd-indicatore.g. non_farm_payrolls, inflation, policy_rateCount down to one named release instead of the next release of any kind.
data-fxmd-paire.g. EUR_USD, USD_JPYFX pair for the macro scorecard and the chart widgets.
data-fxmd-chartcarryChart, yieldDiffChart, yieldCurveChart, baseYieldCurveShape, quoteYieldCurveShape, inflationChart, inflationDiffChart, unemploymentChart, tradeBalanceChartChart to render when the element uses data-fxmd-widget with an FX pair.
data-fxmd-heightPixels, e.g. 560Starting height. The widget then grows to fit its content.
data-fxmd-max-widthCSS length, e.g. 720pxMaximum width. The widget always fills the width of its container up to this limit.
data-fxmd-publisher-idYour publisher IDOptional. Connects the widget to your free publisher stats page.
data-fxmd-consentgrantedOptional. Allows a persistent visitor identifier after your own consent banner. Without it the widget keeps a session-only identifier and sets no cookie on your site.

Snippet or widget address

MethodUse it whenSizing and attribution
HTML snippetThe platform has an HTML, code or custom embed element that runs scripts.The widget grows to fit its content and adds one attribution link beneath it.
Direct widget addressThe platform only frames a link, or strips script tags.You set the frame height. The attribution is shown inside the widget.

Using the widgets

  • Widgets are free on public pages while the FXMacroData attribution stays visible.
  • One script tag serves every widget on a page, and the script finds widget elements added after the page loads.
  • No cookie is set on your site by default. A persistent identifier is only stored when you opt in after your own consent banner.
  • Customer-facing or subscriber-only products use the Commercial Redistribution add-on.

Questions

Is the widget free on this platform?

Limited branded previews are free on public pages, with visible attribution and no monthly pageview cutoff. Full calendars, live feeds, dashboard packs and customer products require Commercial Redistribution.

Do I need an API key or an account?

No. The snippet is everything the widget needs. An optional free publisher ID adds a stats page with views and clicks for your site.

How often does the data update?

Previews show limited snapshots; release headlines are delayed by at least 24 hours. Licensed release feeds refresh every two minutes. No republishing is needed.

Can I change the currencies, language or time zone?

Yes. Each option is an attribute on the widget element. The options reference on the install guide lists every attribute and its values.

Share page X LinkedIn Email