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.
How installation works
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.
| Attribute | Values | What it does |
|---|---|---|
data-fxmd-license | Use the value generated by the widget builder | Public display token for your registered domain. Sign in and use Commercial Redistribution in the builder; never paste an API key here. |
data-fxmd-widget-type | economic-calendar, release-countdown, latest-releases, central-bank-watch, policy-rates, inflation-heatmap, release-ticker, macro-scorecard | Which widget to render. Required for every widget except the FX pair charts. |
data-fxmd-currencies | Comma-separated codes, e.g. USD,EUR,GBP,JPY | Currencies to include. Defaults to the widget's own selection. |
data-fxmd-theme | dark, light, transparent, auto | Colour scheme. auto follows each visitor's light or dark preference. |
data-fxmd-limit | 1 to 12 | Requested rows. Free preview limits are enforced by the server, regardless of this value. |
data-fxmd-importance | all, medium, high | Minimum event importance for the calendar and the countdown. |
data-fxmd-timezone | viewer, or an IANA zone such as Europe/London | Show times in each visitor's local zone or a fixed zone. Defaults to UTC. |
data-fxmd-lang | en, fr, es, pt, zh, ja, de, ar | Widget language. Defaults to the language of your page. |
data-fxmd-indicator | e.g. non_farm_payrolls, inflation, policy_rate | Count down to one named release instead of the next release of any kind. |
data-fxmd-pair | e.g. EUR_USD, USD_JPY | FX pair for the macro scorecard and the chart widgets. |
data-fxmd-chart | carryChart, yieldDiffChart, yieldCurveChart, baseYieldCurveShape, quoteYieldCurveShape, inflationChart, inflationDiffChart, unemploymentChart, tradeBalanceChart | Chart to render when the element uses data-fxmd-widget with an FX pair. |
data-fxmd-height | Pixels, e.g. 560 | Starting height. The widget then grows to fit its content. |
data-fxmd-max-width | CSS length, e.g. 720px | Maximum width. The widget always fills the width of its container up to this limit. |
data-fxmd-publisher-id | Your publisher ID | Optional. Connects the widget to your free publisher stats page. |
data-fxmd-consent | granted | Optional. 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
| Method | Use it when | Sizing and attribution |
|---|---|---|
| HTML snippet | The 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 address | The 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.