<!--
{
  "documentType" : "article",
  "framework" : "Human Interface Guidelines",
  "identifier" : "/design/Human-Interface-Guidelines/image-wells",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "Image wells"
}
-->

# Image wells

An image well is an editable version of an image view.

## Discussion

![A stylized representation of an image well. The image is tinted red to subtly reflect the red in the original six-color Apple logo.](images/com.apple.HIG/components-image-well-intro@2x.png)

After selecting an image well, people can copy and paste its image or delete it. People can also drag a new image into an image well without selecting it first.

## Best practices

**Revert to a default image when necessary.** If your image well requires an image, display the default image again if people clear the content of the image well.

**If your image well supports copy and paste, make sure the standard copy and paste menu items are available.** People generally expect to choose these menu items — or use the standard keyboard shortcuts — to interact with an image well. For guidance, see [Edit menu](/design/Human-Interface-Guidelines/the-menu-bar#Edit-menu).

For related guidance, see [Image views](/design/Human-Interface-Guidelines/image-views).

## Platform considerations

*Not supported in iOS, iPadOS, tvOS, visionOS, or watchOS.*

## Resources

#### Related

[Image views](/design/Human-Interface-Guidelines/image-views)

#### Developer documentation

<doc://com.apple.documentation/documentation/AppKit/NSImageView> — AppKit

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)