This is the official manual for the latest Org-mode release.

## Table of Contents

Next: , Previous: Tables in LaTeX export, Up: LaTeX export

#### 12.10.6 Images in LaTeX export

Images that are linked to without a description part in the link, like ‘[[file:img.jpg]]’ or ‘[[./img.jpg]]’ will be inserted into the PDF output file resulting from LaTeX processing. Org will use an `\includegraphics` macro to insert the image1.

You can specify image width or height with, respectively, `:width` and `:height` attributes. It is also possible to add any other option with the `:options` attribute, as shown in the following example:

```     #+ATTR_LATEX: :width 5cm :options angle=90
[[./img/sed-hr4049.pdf]]
```

If you need a specific command for the caption, use `:caption` attribute. It will override standard `#+CAPTION` value, if any.

```     #+ATTR_LATEX: :caption \bicaption{HeadingA}{HeadingB}
[[./img/sed-hr4049.pdf]]
```

If you have specified a caption as described in Images and tables, the picture will be wrapped into a `figure` environment and thus become a floating element. You can also ask Org to export an image as a float without specifying caption by setting the `:float` attribute. You may also set it to:

• `t`: if you want to use the standard ‘figure’ environment. It is used by default if you provide a caption to the image.
• `multicolumn`: if you wish to include an image which spans multiple columns in a page. This will export the image wrapped in a `figure*` environment.
• `wrap`: if you would like to let text flow around the image. It will make the figure occupy the left half of the page.
• `sideways`: if you would like the image to appear alone on a separate page rotated ninety degrees using the `sidewaysfigure` environment. Setting this `:float` option will ignore the `:placement` setting.
• `nil`: if you need to avoid any floating environment, even when a caption is provided.
To modify the placement option of any floating environment, set the `placement` attribute.
```     #+ATTR_LATEX: :float wrap :width 0.38\textwidth :placement {r}{0.4\textwidth}
[[./img/hst.png]]
```

Images are centered by default. However, one can disable this behavior by setting `:center` attribute to `nil`. To prevent any image from being centered throughout a document, set `org-latex-images-centered` instead.

Eventually, if the `:comment-include` attribute is set to a non-`nil` value, the LaTeX `\includegraphics` macro will be commented out.

#### Footnotes

[1] In the case of TikZ (http://sourceforge.net/projects/pgf/) images, it will become an `\input` macro wrapped within a `tikzpicture` environment.