// troubleshooting guide · datawrapper
Datawrapper Embed Dark Background or Wrong Colors
- Status
- Workaround available
- platforms:
- Web
- updated:
- November 16, 2026
- reports:
- 2
- Method
- how we research
RUNBOOK · datawrapper/dark-mode-embed3 FIXES
// quick answer
Automatic dark mode follows the reader's system setting, so the chart can turn dark on a light site. Turn it off in the Layout tab, or force a mode with ?dark=false / ?dark=true.
Most likely fix: Turn automatic dark mode off
How to fix it
// try these in order, the most common fix is first
FIX 1Turn automatic dark mode off
- 01Open step 3: Visualize > Layout
- 02Switch off automatic dark mode
- 03Republish
Did this fix it?FIX 2Force light or dark per embed
- 01Iframe: add ?dark=false (or ?dark=true) to the chart URL
- 02Script embed: add data-dark="false" (or "true") to the script tag
- 03Sites with their own toggle can switch the parameter to match
Did this fix it?FIX 3Fix mismatched backgrounds
- 01Set color-scheme: dark in CSS on the iframe or its container when the site is dark
- 02Use .hide-in-dark / .hide-in-light classes for inline-styled text
- 03Turn on the option to keep the same colors in dark mode if needed
Did this fix it?
Symptoms
The embedded chart shows a dark background on a light page, a solid background that doesn't match the site, or colors that look wrong in dark mode.
Why it happens
- C-01Automatic dark mode enabled while the website itself has no dark mode
- C-02Browser adds a solid background for legibility
- C-03Inline HTML styles not converted for dark mode
- C-04Custom theme dark mode settings
// this guide also covers
- datawrapper dark mode
- datawrapper chart black background
- datawrapper embed background color
Still not working?
If Datawrapper keeps failing, you're not alone. See every Datawrapper problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to usThe same problem in other apps
Other Datawrapper errors
- Datawrapper Embedded Chart Cut Off or Too Much Space
- Datawrapper Google Sheets Chart Not Updating
- Datawrapper Embed Not Showing Latest Changes
- Datawrapper Not Recognizing Numbers or Dates
- Datawrapper Map Regions Not Matching Data
- Datawrapper Custom Map Upload Not Working
- Datawrapper Locator Map Not Exporting
- Datawrapper Export PDF or SVG Not Available