Using org-image-actual-width will both downscale and upscale. I just want to downscale big images to fit the current width. Any ideas?

1 Answer 1


The doc string for org-image-actual-width says (among other things):

When set to nil, try to get the width from an #+ATTR.* keyword and fall back on the original width if none is found.

So set it to nil and specify the width with an #+ATTR keyword only for the big images that you want to downscale. More info can be found in the manual in the Exporting chapter, in section Images for HTML export and section Images in LaTeX export.

  • 3
    This is not automatic downscaling. I'd need to automate adding an ATTR for each inserted image, and even then it would be hardcoded to my current screen resolution.
    – HappyFace
    Aug 18, 2020 at 19:21
  • 2
    I never said it was, but that's the best you can do I believe: Org mode has no idea what the size of an image you give it is - it will either insert it as is (no size spec) or it will set the size you tell it.
    – NickD
    Aug 18, 2020 at 19:28
  • 2
    There's no reason org-mode couldn't find out the image size and do something smart though; org-mode uses create-image which accepts a :max-width parameter in PROPS. Could be worth submitting a patch @HappyFace ;-)
    – unhammer
    Mar 15, 2021 at 13:19
  • Any update on this? Should we submit an issue somewhere?
    – falematte
    Mar 16, 2022 at 10:23

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.