// troubleshooting guide · darktable
darktable Black Image on Export or in Darkroom
- Status
- Workaround available
- platforms:
- Windows, macOS, Linux
- updated:
- November 17, 2026
- reports:
- 3
- Method
- how we research
RUNBOOK · darktable/black-image-export4 FIXES
// quick answer
A black image in darktable is most often an OpenCL bug. Disable OpenCL or the offending module (haze removal, filmic or sigmoid on some GPUs), update drivers and retry the export.
Most likely fix: Test with OpenCL off
How to fix it
// try these in order, the most common fix is first
FIX 1Test with OpenCL off
- 01Start darktable --disable-opencl
- 02Open the image and export again
Did this fix it?FIX 2Disable the suspect module
- 01In darkroom, switch off recently used modules such as haze removal one by one
- 02Check the filmic and color balance modules
Did this fix it?FIX 3Update darktable and driver
- 01Install 5.6.2 which fixes some OpenCL clipping issues
- 02Update GPU driver
Did this fix it?FIX 4Reset the image history
- 01In lighttable use history stack > discard history on a test copy
Did this fix it?
SANDBOX · darktable RUNS IN YOUR BROWSER
Try it: edit a layered image, paint, generate and export it
A hands-on darktable-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.
Symptoms
The darkroom center image or exported JPEG/TIFF is completely black or half corrupted.
Why it happens
- C-01OpenCL driver bug
- C-02Specific module with GPU
- C-03Outdated darktable on new GPU
- C-04Clipping/highlight settings
// this guide also covers
- darktable black image
- darktable export black
- darkroom black image darktable
Still not working?
If darktable keeps failing, you're not alone. See every darktable 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
All export, render & quality loss guides →
Lightroom Classic Export Not Working or Stuck (Adobe Lightroom)
DxO PhotoLab Export Failed (Unknown Error in Correction Engine) (DxO PhotoLab)
Capture One Export Not Working (Process Queue Stuck) (Capture One)
Affinity Photo Export Not Working (Affinity Photo)