How to embed visualizations
Once you hit the big blue "Publish" button in step 4: Publish of the map, table or chart creation process, you see this:
In this article, we will explain these options in detail and answer some questions you might have:
Share via URL
Here you have two options, "Visualization only" and "For sharing". You can use these URLs to share your charts easily or embed charts in specific platforms:
Choose "Visualization only" if you want to share a fullscreen version of your chart. It will probably look stretched. Example: //datawrapper.dwcdn.net/Wa2Ci/18/.
Choose "For sharing" if you want to link to a page on which the chart appears with your chosen height and width. That's great for social media or for showing the chart to a co-worker before embedding it. Example: https://www.datawrapper.de/_/Wa2Ci/
👉 You will notice that the 'Visualization only' links show a trailing number, e.g. the 18 here: //datawrapper.dwcdn.net/Wa2Ci/18/. This is the versioning number. Every time you hit "Re-publish", this number counts up.
However, the charts in all versions are the same. The link datawrapper.dwcdn.net/Wa2Ci/10/ shows the same chart as the link datawrapper.dwcdn.net/Wa2Ci/3 or the link datawrapper.dwcdn.net/Wa2Ci/ . They all forward eventually to the latest version of the chart, which, in our case, is datawrapper.dwcdn.net/Wa2Ci/18/.
Share or embed the version-numbered chart URL if you want to make sure that users on your website see the latest version of your chart immediately. Why? Because if someone had opened your article before and you did not update the chart URL, they might see an outdated ("cached") version of the chart. Also, it might take a small amount of time on our site to update the chart in all chart URLs.
Copy Embed code
Here you have two options, "responsive iframe" and "iframe".
- Choose "responsive iframe" (recommended), if you want readers to see a version of a chart that's adapted to their screen size. Here's an example: On a mobile phone, the headline normally breaks into two or more lines; taking up more space within the iframe. The responsive iframe will become taller to avoid that your chart gets squeezed or cut off.
👉 Both responsive iframe and iframe include the size of your chart. Meaning, they tell your website in which format ratio they should display the chart (more wide than tall? taller than wide? square?). If you change the size of your chart, copy a new embed code in your article or CMS.
If you're interested in the details: The responsive iframe is like the iframe but with a script attached to it. That's how the normal iframe looks like for our chart:
<iframe title="Presidential Approval Ratings Since Kennedy" aria-label="Interactive line chart" id="datawrapper-chart-Wa2Ci" src="//datawrapper.dwcdn.net/Wa2Ci/18/" scrolling="no" frameborder="0" style="border: none;" width="1345" height="578"></iframe>
And here's what the responsive iframe looks like:
- For more details on responsive iframes, visit "Responsive iframe" in our developer docs.
- You can also customize your own embed code template. To learn how to do this, visit "Custom embed code" in our developer docs.
- Is your chart getting cut off? For troubleshooting regarding iframes, read our academy article "My embedded charts are cut off or have too much space underneath".