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
Website builder
Wix
Add a live economic calendar, countdown, central bank rates table or FX macro chart to a Wix page with the Embed HTML element.
CMS
WordPress
Use a Custom HTML block in the block editor, or the FXMacroData Widgets plugin for a shortcode and a block.
Static hosting
Netlify and static sites
Paste one snippet into your HTML and deploy. The same steps work on Netlify, Vercel, GitHub Pages and Cloudflare Pages.
Website builder
Webflow
Drop a Code Embed element onto the page, paste the snippet and publish.
Website builder
Squarespace
Add a Code block to the page, paste the snippet and save.
Store builder
Shopify
Add a Custom Liquid section or block in the theme editor and paste the snippet.
Publishing platform
Ghost
Use an HTML card in the editor, or paste the widget page link and let Ghost embed it.
Publishing platform
Blogger
Use an HTML/JavaScript gadget for the sidebar, or the HTML view for a single post.
Website builder
Google Sites
Use Insert, Embed and paste the direct widget address.
Workspace
Notion
Add an Embed block and paste the direct widget address.
JavaScript framework
React and Next.js
Render the widget element in a component and load the script once. The script finds widget elements added after the page loads.
AI-built sites
AI website builders
Ask the builder to insert the snippet exactly as written. It needs no API key, backend or data-fetching code.
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-widget-type | <built-in method values of dict object at 0x0000026D809FE340> | Which widget to render. Required for every widget except the FX pair charts. |
data-fxmd-currencies | <built-in method values of dict object at 0x0000026D80AA7E80> | Currencies to include. Defaults to the widget's own selection. |
data-fxmd-theme | <built-in method values of dict object at 0x0000026D80A980C0> | Colour scheme. auto follows each visitor's light or dark preference. |
data-fxmd-limit | <built-in method values of dict object at 0x0000026D80A98100> | Number of rows. Leave it out to use the widget's default. |
data-fxmd-importance | <built-in method values of dict object at 0x0000026D80A98040> | Minimum event importance for the calendar and the countdown. |
data-fxmd-timezone | <built-in method values of dict object at 0x0000026D80AA7EC0> | Show times in each visitor's local zone or a fixed zone. Defaults to UTC. |
data-fxmd-lang | <built-in method values of dict object at 0x0000026D80AA7FC0> | Widget language. Defaults to the language of your page. |
data-fxmd-indicator | <built-in method values of dict object at 0x0000026D80AA7E00> | Count down to one named release instead of the next release of any kind. |
data-fxmd-pair | <built-in method values of dict object at 0x0000026D80AA7BC0> | FX pair for the macro scorecard and the chart widgets. |
data-fxmd-chart | <built-in method values of dict object at 0x0000026D80AA7E40> | Chart to render when the element uses data-fxmd-widget with an FX pair. |
data-fxmd-height | <built-in method values of dict object at 0x0000026D80AA7F00> | Starting height. The widget then grows to fit its content. |
data-fxmd-max-width | <built-in method values of dict object at 0x0000026D809FDF40> | Maximum width. The widget always fills the width of its container up to this limit. |
data-fxmd-publisher-id | <built-in method values of dict object at 0x0000026D80A9BEC0> | Optional. Connects the widget to your free publisher stats page. |
data-fxmd-consent | <built-in method values of dict object at 0x0000026D80A98140> | 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?
Yes. Standard widgets on public pages are free while the FXMacroData attribution link stays visible. Customer-facing or subscriber-only products use the Commercial Redistribution add-on.
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?
The widget loads current data each time the page is opened, and the release ticker refreshes itself every two minutes. You never need to republish the page.
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.