---
title: useCanvasDrop
description: Image file drag-and-drop helper for canvas surfaces.
---

# useCanvasDrop

`useCanvasDrop(canvasRef, editor)` wires dragenter, dragover, dragleave, and drop handling so image files dropped on the canvas are placed into the scene.

Use it when building custom canvas surfaces that accept image drops.

## Related APIs

- [CanvasRoot](../components/canvas-root)
- [CanvasSurface](../components/canvas-surface)
- [extractImageFilesFromClipboard](./extract-image-files-from-clipboard)