Skip to content
Handbook Open tldraw notes

Sharing and export

Images and PDFs

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

WebiPadiPhoneAndroid

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 ⌘U. 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. 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, or choose Convert to ink… 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.