Inserting Media
Add media to your documents using the slash menu, the plus button, or drag and drop.- macOS
- iOS
- Windows/Web
Type 
/ and select the desired media type from the menu. You can also drag and drop images into the Mac app from your folders or from any website.
For header images, we recommend using a 1200 x 630 image size for optimal display.
Images
Craft preserves the original quality of your images. Opening an image in preview (by tapping or double-clicking) always renders the full quality, as does downloading the image from Craft.
Supported Image Formats
Craft supports all standard image formats including:- PNG, JPEG, GIF - Traditional web formats
- WebP - Modern web format with better compression
- AVIF (Advanced Video Image Format) - Next-generation format with superior compression
- SVG - Vector graphics (preserved as vector data, shown as attachment blocks)
- HEIC - iOS native format (when uploaded from iOS/Mac)
- Up to 50% smaller file sizes compared to JPEG
- Better quality at smaller file sizes
- Ideal for documents with many images, reducing storage usage
.webp and .heic images uploaded through Web or Windows apps may appear as attachment blocks. For best compatibility across all platforms, use PNG or JPEG formats.
Automatic Layout
Craft intuitively arranges images with similar sizes together when you place them side by side. The thumbnail in your document may have a lower resolution to preserve app performance, but the original quality is always maintained.Rearranging Images
To rearrange automatically grouped images, you can:- Move them to other blocks in the document
- Change the “Image Size” configuration from “Auto” to “Large” in the … menu

Gallery View
View all images in a document as a unified gallery for quick browsing and review. This is particularly useful when working with image-heavy documents like photo collections, design reviews, or visual research. Features:- Grid layout showing all document images
- Quick navigation between images
- Preview and zoom capabilities
- Visual overview of all media in one place
- Photo organization and selection
- Visual content review
- Design iteration comparison
- Quick access to specific images
Gallery view availability and activation method may vary by platform. Check your platform’s view menu or document options for this feature.
Videos
Craft does not convert or compress video files - the original quality is preserved. You can upload any video format into a Craft document.Video Formats
- Supported previews - .mp4 and .mov files display a thumbnail preview
- Attachment blocks - Other formats like .avi, .wmv, and less common formats are displayed as standard attachment blocks

Playing Videos
Videos with thumbnail previews open in a separate player within Craft. Videos displayed as attachment blocks need to be downloaded first and played with a compatible program.
Audio Files
Audio files are displayed as standard attachment blocks in your documents. When you click or tap on an audio file, it opens in a separate player window.

Unsplash Integration
Craft integrates with Unsplash, giving you access to millions of high-quality, free photos. When inserting an image, select the Unsplash option to browse and search for professional photos directly within Craft. This is particularly useful for:- Header images
- Visual inspiration
- Professional-looking documents
- Presentations and published pages
