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

# Cover Images

> Add and customize cover images for your documents with cropping, positioning, and aspect ratio options.

Cover images add a visual header to your Craft documents, helping create a polished, professional look. You can upload your own images or select from Unsplash's collection of professional photos.

## Adding a Cover Image

<Tabs>
  <Tab title="macOS">
    <Steps>
      <Step>
        Open your document
      </Step>

      <Step>
        In the right sidebar, select the **Style** section
      </Step>

      <Step>
        Click on the **Cover Image** option
      </Step>

      <Step>
        Choose to **upload your own image** or select one from **Unsplash**
      </Step>
    </Steps>
  </Tab>

  <Tab title="Web">
    <Steps>
      <Step>
        Open your document
      </Step>

      <Step>
        In the right sidebar, select the **Style** section
      </Step>

      <Step>
        Click on the **Cover Image** option
      </Step>

      <Step>
        Choose to **upload your own image** or select one from **Unsplash**
      </Step>
    </Steps>
  </Tab>

  <Tab title="iOS">
    <Steps>
      <Step>
        Open your document
      </Step>

      <Step>
        Tap the three-dot menu
      </Step>

      <Step>
        Select **Page Style**
      </Step>

      <Step>
        Choose **Cover Image**
      </Step>

      <Step>
        Select to **upload your own image** or choose from **Unsplash**
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Customizing Your Cover Image

Once you've added a cover image, you can edit, crop, and customize it to fit your needs.

<Steps>
  <Step>
    Hover over the bottom-right corner of the cover image
  </Step>

  <Step>
    Click the **pencil icon** that appears
  </Step>

  <Step>
    Use the editing tools to crop and position your image
  </Step>

  <Step>
    Click **Done** when finished
  </Step>
</Steps>

<iframe src="https://www.loom.com/embed/b18a0d437cfc469c9deb5e7985e8a552" title="Customizing cover images in Craft" className="w-full aspect-video rounded-xl" allowFullScreen />

## Cropping Options

You can crop your cover image to specific aspect ratios from the grid dropdown:

* **Default** - Original image proportions
* **16:9** - Widescreen format
* **2:1** - Ultra-wide format
* **3:1** - Extra-wide banner
* **4:3** - Classic display ratio
* **Freeform** - Drag corners for custom sizing

<Info title="Editing Tips">
  - **Zoom out**: Hold down `Cmd` (Mac) or `Ctrl` (Windows) while editing
  - **Drag image**: Hold down the `Space` bar to reposition the image
  - **Reset**: Select **Reset** from the grid dropdown to start fresh
</Info>

## Removing a Cover Image

To remove a cover image from your document:

<Steps>
  <Step>
    Hover over the cover image
  </Step>

  <Step>
    Click the **X** icon that appears
  </Step>
</Steps>

## Using Unsplash Images

Craft's Unsplash integration provides instant access to high-quality, professional photos:

<Steps>
  <Step>
    When adding a cover image, select **Unsplash**
  </Step>

  <Step>
    Search for keywords related to your document's topic
  </Step>

  <Step>
    Click on an image to add it as your cover
  </Step>
</Steps>

All Unsplash images are free to use and don't require attribution, though it's appreciated.

## Related Articles

<CardGroup cols={2}>
  <Card title="Styles Quick Guide" href="/en/write-and-edit/styling/quick-guide">
    Comprehensive guide to all styling features
  </Card>

  <Card title="Cards" href="/en/write-and-edit/styling/cards">
    Turn pages into visual card layouts
  </Card>

  <Card title="App Styles" href="/en/write-and-edit/styling/app-styles">
    Extend document styles to the app interface
  </Card>
</CardGroup>