Add and edit images

You can add photos and graphics to a document from a photo library, or drag photos and graphics from a website or from the Finder. You can crop an image by masking out parts you don’t want, and make adjustments to its background and exposure.

Add or replace an image

Do any of the following:

If you can’t replace an image on a page, the image may be locked or grouped, or it may be a master object.

Add an image gallery

With an image gallery, you can view a collection of photos in one place on a page, so only one shows at a time. In a document that’s exported in EPUB format, you can click through the images in an interactive gallery, as you would through a slideshow.

  1. Click the Media button in the toolbar, then choose Image Gallery.

  2. Drag the image gallery to reposition it on the page, and drag any selection handle to resize it.

  3. To add images, drag them from your computer to the image gallery.

  4. To customize the image gallery, make sure it’s still selected, then do any of the following:

    • Adjust the position or zoom level of an image: Double-click the image on the page, then drag it to move it in the frame. Drag the slider to zoom.

    • Reorder images: In the Format  sidebar, click the Gallery tab, then drag image thumbnails to reorder them.

    • Add an image caption: Double-click the text box below the image on the page, then enter your text.

      To use the same caption for all images, in the Format sidebar, click the Gallery tab, then select “Same caption for all images.” Double-click the text box below any image and enter your text.

      To turn off captions, deselect Caption.

    • Add an image description that can be used by assistive technology (for example, VoiceOver): Click the Gallery tab in the Format sidebar, then click an image thumbnail. Enter your text in the Image Description text box. The image description isn’t visible anywhere in your document.

  5. To view the image gallery, click the Left Browse button or the Right Browse button.

To remove an image from the gallery, in the Format sidebar, click the Gallery tab, click the image thumbnail, then press Delete.

Create a media placeholder

You can add a media placeholder (to which you can add an image, video, or audio file) to a document. Using a media placeholder lets you easily replace media without disturbing other elements on the page.

  1. Add an image to the document, then format it how you want images to appear in the document.

    You can add a mask, add a border, rotate the image, change its size, and more.

  2. Select the image, then choose Format > Advanced > Define as Media Placeholder (from the Format menu at the top of your screen).

If you can’t replace an image or other object

If you can’t replace an object on a template, the object may be locked or it may be a master object. To make it editable, do one of the following:

Take a photo or scan with an iOS device and add it to a document

If you have an iOS device nearby, you can use it to take a photo or scan and insert it directly into your document on your Mac.

Note: To make sure you can do this with your Mac and iOS device, see the Apple Support article System requirements for Continuity on Mac, iPhone, iPad, iPod touch, and Apple Watch.

  1. On the page where you want to add the photo or scan, click the Media button in the toolbar, then choose Take Photo or Scan Documents below your device name.

  2. On your iOS device, do one of the following:

    • Take a photo: Tap  the Shutter button, then tap Use Photo (tap Retake to retake the photo).

    • Scan a document automatically: Position the document in view of the camera to automatically capture the page, crop it, and correct its perspective. To insert the scan in your document, tap Save.

    • Scan a page manually: Tap  the Shutter button, then drag the frame to adjust the area you want to scan. Tap Keep Scan, then tap Save.

  3. Drag the image to move it, or drag any selection handle to resize it in your document.

Note: If you scan more than one item, only the first one appears in your document.

Mask (crop) a photo

You can hide unwanted portions of an image without modifying the image file.

  1. Double-click the image.

    The mask controls appear. The default mask is the same size as your image.

    Tip: To display the mask controls on a Mac with a Force Touch trackpad, force click the image (press firmly on the trackpad until you feel a deeper click).

  2. Use the controls to frame just the parts of the image you want to be visible.

    Mask controls over a photo.
  3. Click Done.

To mask an image with a shape, select the image, choose Format > Image > Mask With Shape, then choose a shape. Drag the handles on the shape to adjust its dimensions.

Remove background and other elements from a photo

Use the Instant Alpha tool to make parts of an image transparent. This feature is useful for removing an unwanted background or color from an image.

  1. Select the image.

  2. In the Format  sidebar, click the Image tab.

  3. Click Instant Alpha.

  4. On the image, click the color you want to remove, then drag slowly over it.

    As you drag, the selection grows to include areas that use similar colors. Click and drag multiple times to remove multiple colors.

    • Remove all of the color (even in other parts of the image): Press the Option key on the keyboard as you drag.

    • Add a color back to the image: Press the Shift key on the keyboard as you drag.

  5. Click Done, or click Reset to undo all your changes and restore the image to its original state.

Adjust exposure, saturation, and other image settings

  1. Select the image.

  2. In the Format  sidebar, click the Image tab.

  3. Use the controls to make adjustments:

    • Exposure: Changes the overall lightness or darkness of the image.

    • Saturation: Changes the richness of color in the image. Dragging to the right makes the colors richer or more vibrant.

    • Enhance: Automatically adjusts the image by spreading the red, green, and blue tones evenly across the histogram.

  4. To see the image histogram and adjust more advanced features like contrast, highlights, shadows, sharpness, de-noise, temperature, and tint, click the Advanced image button.

    The Adjust Image window with sliders for setting exposure, contrast, saturation, highlights, shadows, sharpness, de-noise, temperature, and tint.

You can open the Adjust Image controls in a separate window that you can move anywhere. Choose View > Show Adjust Image (from the View menu at the top of your screen).

To restore the image’s original settings, click Reset, or click Reset Image in the Adjust Image window.

Add an image description

You can add a description to any image in your document. Image descriptions are read by assistive technology (for example, VoiceOver) when somebody uses that technology to access your document. Image descriptions aren’t visible anywhere in your document.

  1. Select the image, then, in the Format  sidebar, click the Image tab.

  2. Click the Description text box, then enter your text.

To add descriptions to the images in an image gallery, see “Add an image gallery,” above.

To learn about adding a caption to your image, see Add a caption.

Tip: You can add these buttons to the toolbar: Adjust Image, Instant Alpha, and Mask.

See alsoPlace objects with textFill shapes and text boxes with color or an imageUse object stylesResize, rotate, and flip objectsPosition and align objects