> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Media

> Add and manage images, videos, audio files, and rich media content in your documents.

Craft lets you insert photos, videos, and audio files from your camera, photo library, files, or from Unsplash. Media content looks beautiful in your documents, and Craft automatically arranges them in the best possible layout.

<iframe src="https://www.youtube-nocookie.com/embed/3lA7VIjvCis" title="Inserting photos, videos, and files in Craft" className="w-full aspect-video rounded-xl" allowFullScreen />

## Inserting Media

Add media to your documents using the slash menu, the plus button, or drag and drop.

<Tabs>
  <Tab title="macOS">
    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.

    <img src="https://mintcdn.com/craft-support/L5zMoIm2o8A5WVUD/images/write-and-edit/media/en/content/insert-media-mac.gif?s=e0cf78d06f9bcca8ded646a478c438fe" alt="Inserting media on macOS" width="874" height="1020" data-path="images/write-and-edit/media/en/content/insert-media-mac.gif" />
  </Tab>

  <Tab title="iOS">
    Type `/` while editing and select the desired option from the menu. You can also tap the **+** button in the bottom left corner to see the list of options.

    <img src="https://mintcdn.com/craft-support/L5zMoIm2o8A5WVUD/images/write-and-edit/media/en/content/insert-media-ios.gif?s=4de6608bad409e148a2afd5848ab0d27" alt="Inserting media on iOS" width="406" height="876" data-path="images/write-and-edit/media/en/content/insert-media-ios.gif" />
  </Tab>

  <Tab title="Windows/Web">
    Use the forward slash symbol, the insert tab, or drag and drop a media file into your document.
  </Tab>
</Tabs>

<Info title="Header Images">
  For header images, we recommend using a 1200 x 630 image size for optimal display.
</Info>

## 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.

<img src="https://mintcdn.com/craft-support/L5zMoIm2o8A5WVUD/images/write-and-edit/media/en/content/images-layout.png?fit=max&auto=format&n=L5zMoIm2o8A5WVUD&q=85&s=92de87badd580fcd7f79108781cd70ad" alt="Image layout example" width="1464" height="1358" data-path="images/write-and-edit/media/en/content/images-layout.png" />

### 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)

**AVIF Benefits:**

* Up to 50% smaller file sizes compared to JPEG
* Better quality at smaller file sizes
* Ideal for documents with many images, reducing storage usage

<Info title="Format Handling">
  **.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.
</Info>

### 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

<img src="https://mintcdn.com/craft-support/L5zMoIm2o8A5WVUD/images/write-and-edit/media/en/content/rearrange-images.gif?s=90e2d9d943add806656a6752a202e524" alt="Rearranging images" width="800" height="662" data-path="images/write-and-edit/media/en/content/rearrange-images.gif" />

<Warning title="Image Editing">
  It is currently not possible to crop or edit uploaded images within Craft.
</Warning>

### 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

**Use Cases:**

* Photo organization and selection
* Visual content review
* Design iteration comparison
* Quick access to specific images

<Info title="Availability">
  Gallery view availability and activation method may vary by platform. Check your platform's view menu or document options for this feature.
</Info>

## 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

<img src="https://mintcdn.com/craft-support/L5zMoIm2o8A5WVUD/images/write-and-edit/media/en/content/video-preview.png?fit=max&auto=format&n=L5zMoIm2o8A5WVUD&q=85&s=2b77eef6513099166b3b5a61cabeb937" alt="Video format preview" width="753" height="1054" data-path="images/write-and-edit/media/en/content/video-preview.png" />

### 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.

<img src="https://mintcdn.com/craft-support/L5zMoIm2o8A5WVUD/images/write-and-edit/media/en/content/video-player.gif?s=467f825da8b2523f052fcfa64f0e297b" alt="Video player" width="800" height="756" data-path="images/write-and-edit/media/en/content/video-player.gif" />

<Warning title="Note">
  Craft does not yet have an embedding feature for videos from external platforms like YouTube or Vimeo.
</Warning>

## 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.

<img src="https://mintcdn.com/craft-support/L5zMoIm2o8A5WVUD/images/write-and-edit/media/en/content/audio-block.png?fit=max&auto=format&n=L5zMoIm2o8A5WVUD&q=85&s=df9b04b2406f90713db584ad3d04c5be" alt="Audio file block" width="744" height="505" data-path="images/write-and-edit/media/en/content/audio-block.png" />

The audio player provides playback controls for your audio content.

<img src="https://mintcdn.com/craft-support/L5zMoIm2o8A5WVUD/images/write-and-edit/media/en/content/audio-player.gif?s=6234066e3c8b10cd67e7ce59b415f0db" alt="Audio player interface" width="748" height="522" data-path="images/write-and-edit/media/en/content/audio-player.gif" />

## 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

## Image Playground

On devices with Apple Intelligence (iOS 18.2+, macOS 15.2+), you can generate custom images directly in Craft using Image Playground. Create AI-generated images from text descriptions in Animation, Illustration, or Sketch styles - perfect for visual brainstorming, placeholder images, and creative projects.

[Learn more about Image Playground](/en/write-and-edit/image-playground)