# Images and PDFs

Bring in photos, screenshots, and PDFs to write on.

Platforms: Web, iPad, iPhone, Android

Put an image or a PDF on the canvas and write on top of it: mark up a screenshot, annotate a paper, fill in a form.

## Add an image or PDF

| Platform | How |
| --- | --- |
| Web | Choose **Upload media…** in the editor menu, or press <kbd>⌘</kbd><kbd>U</kbd>. You can also drag files onto the canvas, or paste an image. |
| iPad, iPhone, and Android | Choose **Upload media…** in the editor menu, then **Photo library** or **Files (cached copy)**. If you've copied an image or PDF, **Paste image** or **Paste PDF** is there too. On iPad you can also drag files in from another app. |

Images can be PNG, JPEG, GIF, or WebP. Photos from an iPhone or iPad photo library are converted to JPEG on the way in. Very large images are scaled down to fit.

A file you bring in is copied into the note. Changing or deleting the original afterwards doesn't affect the note.

## PDFs

Each page of a PDF becomes an image, laid out in a column on the canvas. A progress message shows while the pages come in.

If some pages can't be read, the rest still come in, and tldraw notes tells you how many made it. A PDF can be up to 32 MB, and up to 200 pages come in from each one. Password-protected PDFs can't be imported.

On the web, PDF import works offline once the app has finished setting itself up for offline use after your first visit.

## Working with images

An image is selected, moved, resized, rotated, copied, and deleted like ink; see [Selecting](selecting.md). Images always keep their proportions. To return a resized image to its original size, open its context menu and choose **Original image size** (or double-click a resize handle on the web). Write on top with the [pencil or highlighter](pencil-and-highlighter.md), or choose **[Convert to ink…](convert-to-ink.md)** in its context menu to trace it into editable strokes and fills.

## When an image doesn't show

An image you added on another device has to download before it appears. While it does, you'll see one of three placeholders:

| Placeholder | What it means |
| --- | --- |
| Loading | The image is on its way. |
| Unavailable offline | This device doesn't have it yet. It appears when you're back online. |
| Missing | The image can't be found. |

An image you add while offline is saved on this device straight away and uploads when you reconnect.
