---
title: "Combo Boxes"
platform: macOS
category: foundations
url: https://developer.apple.com/design/human-interface-guidelines/combo-boxes
id: combo-boxes-macos
lastUpdated: 2025-06-26T23:27:23.419Z
extractionMethod: enhanced-turndown
qualityScore: 0.528
confidence: 0.728
contentLength: 1360
structureScore: 0.500
cleaningScore: 0.116
hasCodeExamples: false
hasImages: false
keywords: ["combo", "boxes", "box", "combines", "text", "field", "pull", "down", "button", "single"]
---
## Overview

Combo boxes A combo box combines a text field with a pull-down button in a single control. People can enter a custom value into the field or click the button to choose from a list of predefined values. When people enter a custom value, it’s not added to the list of choices. Best practices Populate the field with a meaningful default value from the list. Although the field can be empty by default, it’s best when the default value refers to the hidden choices. The default value doesn’t have to be the first item in the list. Use an introductory label to let people know what types of items to expect. Generally, use title-style capitalization for labels and end them with a colon. For related guidance, see Labels. Provide relevant choices. People appreciate the ability to enter a custom value, as well as the convenience of choosing from a list of the most likely choices. Make sure list items aren’t wider than the text field. If an item is too wide, the text field might truncate it, which is hard for people to read. For guidance, see Text fields and Pull-down buttons. Platform considerations Not supported in iOS, iPadOS, tvOS, visionOS, or watchOS. Resources Related Text fields Pull-down buttons Developer documentation NSComboBox — AppKit Current page is Combo boxes Supported platforms Combo boxes Best practices Platform considerations Resources

## Related Concepts

- button
- buttons
- text field
- text fields

---

**Attribution Notice**

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

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.