---
title: "Color Wells"
platform: macOS
category: foundations
url: https://developer.apple.com/design/human-interface-guidelines/color-wells
id: color-wells-macos
lastUpdated: 2025-06-26T23:27:42.406Z
extractionMethod: enhanced-turndown
qualityScore: 0.519
confidence: 0.719
contentLength: 1382
structureScore: 0.500
cleaningScore: 0.116
hasCodeExamples: false
hasImages: false
keywords: ["color", "wells", "well", "lets", "people", "adjust", "text", "shapes", "guides", "other"]
---
## Overview

Color wells A color well lets people adjust the color of text, shapes, guides, and other onscreen elements. A color well displays a color picker when people tap or click it. This color picker can be the system-provided one or a custom interface that you design. Best practices Consider the system-provided color picker for a familiar experience. Using the built-in color picker provides a consistent experience, in addition to letting people save a set of colors they can access from any app. The system-defined color picker can also help provide a familiar experience when developing apps across iOS, iPadOS, and macOS. Platform considerations No additional considerations for iOS, iPadOS, or visionOS. Not supported in tvOS or watchOS. macOS When people click a color well, it receives a highlight to provide visual confirmation that it’s active. It then opens a color picker so people can choose a color. After they make a selection, the color well updates to show the new color. Color wells also support drag and drop, so people can drag colors from one color well to another, and from the color picker to a color well. Resources Related Color Developer documentation UIColorWell — UIKit UIColorPickerViewController — UIKit NSColorWell — AppKit Color Programming Topics Current page is Color wells Supported platforms Color wells Best practices Platform considerations Resources

## Related Concepts

- picker
- color

---

**Attribution Notice**

This content is sourced from Apple's Human Interface Guidelines: https://developer.apple.com/design/human-interface-guidelines/color-wells

This content was extracted with good confidence. Structure and guidelines have been enhanced for better usability.

© Apple Inc. All rights reserved. This content is provided for educational and development purposes under fair use. This MCP server is not affiliated with Apple Inc. and does not claim ownership of Apple's content.

For the most up-to-date and official information, please refer to Apple's official documentation.