Insert images
Add images to topics through upload, paste, or drag-and-drop.
Upload an image
Place your cursor where you want the image.
Type
/and select Image, or click the image button in the toolbar.Select a file from your computer.
The image uploads to storage and appears in the editor.
Paste or drag-and-drop
Paste: Copy an image to your clipboard and press Cmd+V in the editor. The image uploads automatically.
Drag-and-drop: Drag an image file from Finder into the editor area.
Image limits
Maximum file size: 5 MB per image
Supported formats: PNG, JPG, GIF, WebP, SVG
Images that exceed the 5 MB limit are rejected during upload. Resize or compress large images before adding them. SVG files are supported but are not processed for optimization.
Use WebP format for the best balance of quality and file size. WebP images are typically 25-35% smaller than equivalent PNGs or JPGs, which helps your published pages load faster.
Images in published sites
Images render at their natural size, constrained to the content width. On mobile, they scale down to fit the viewport.
See also
Format content in the editor — Full overview of editor formatting options
Use slash commands — Insert images and other blocks from the keyboard
Published site features — How images and other content render on published sites
Customize your site's branding — Control the look of your published site