# Images

All common image formats such as `jpg`, `png`, and `gif` are supported. Outline will also detect retina images and display them at the correct size automatically.

# Inserting

You have several options to add images to a document:

* Paste an image from the clipboard with the keyboard or mouse
* Drag and drop an image from your desktop
* Type `/image` to trigger a file uploader
* In a comment click the photo icon ![](https://outline-production-attachments.s3-accelerate.amazonaws.com/uploads/292079f8-0319-4111-bb5b-315e8ae8f14e/3db42217-55aa-47f5-ba19-f6022a56f54d/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA4EOUDTOVUICLPZ4P%2F20260902%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260902T024500Z&X-Amz-Expires=86400&X-Amz-Signature=9264caee150fa3a9ec0abfcc6e6ecdf0873b350395f5e1215683fb1abfd7a22c&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =24x24")
* Select an existing image and choose the “Replace” option in the toolbar
* Type the markdown `![alt](url)` (this also allows inserting remote images)

# Size & layout

Hover over the edges of an image to see a resize cursor, you can click and drag to resize - the aspect ratio will be automatically retained.

If you need accurate sizing then click to focus the image and then the toolbar will offer inputs to enter specific pixel-based sizing.

## Layout options

Outline offers some layout options for images. By default images are inserted centered, however you can choose left or right aligned and full-width.

## Icon images

Small images below 32x32px are treated as icons and will automatically display inline with text like the “photo” icon above. Other layout options and captions are not available for these very small images.

# Captions

Click to select an image to see the option to “Add a caption”, simply type into this space to add descriptive text for the image. Any added text will also become alt text for the image for accessibility purposes.

Formatting is not supported inside of captions.

---

**Documents**

- [Getting started](https://docs.getoutline.com/s/guide/doc/getting-started-CB6Ipl9Cdc)
- [Documents](https://docs.getoutline.com/s/guide/doc/documents-UiH1h0aQFQ)
- [Integrations](https://docs.getoutline.com/s/guide/doc/integrations-eUbAF2WAjF)
- [AI](https://docs.getoutline.com/s/guide/doc/ai-IFCYbrK7EU)
- [Administration](https://docs.getoutline.com/s/guide/doc/administration-GmaueCNdk1)
- [Import data](https://docs.getoutline.com/s/guide/doc/import-data-D2ZvLqz411)
- [Export data](https://docs.getoutline.com/s/guide/doc/export-data-Da6C7HqL8M)
- [Cloud hosting](https://docs.getoutline.com/s/guide/doc/cloud-hosting-CxJbubIhje)