sickn33/agentic-awesome-skills / plugins/aasb-aas-mobile-app-builder/skills/hig-patterns
hig-patterns
VerifiedApple Human Interface Guidelines interaction and UX patterns.
references/entering-data.md
View on GitHub---
title: "Entering data | Apple Developer Documentation"
source: https://developer.apple.com/design/human-interface-guidelines/entering-data
---
# Entering data
> Attributed Apple HIG snapshot with local review corrections. Confirm current target OS/SDK and device capabilities in the linked documentation. Historical examples are design guidance, not guaranteed behavior, endorsement or a complete implementation. No native app/device tests were performed.
When you need information from people, design ways that make it easy for them to provide it without making mistakes.

Entering information can be a tedious process regardless of the interaction methods people use. Improve the experience by:
* Reusing only necessary data already available within the person’s permissions and expectations to reduce redundant entry
* Supporting all available input methods so people can choose the method that works for them
## [Best practices](https://developer.apple.com/design/human-interface-guidelines/entering-data#Best-practices)
**Get information from the system whenever possible.** Don’t ask people to enter information that you can gather automatically — such as from settings — or by getting their permission, such as their location or calendar information.
**Be clear about the data you need.** For example, you might display a prompt in a text field — like “username@company.com” — or provide an introductory label that describes the information, like “Email.” You can also prefill fields with reasonable default values, which can minimize decision making and speed data entry.
**Use a secure text-entry field when appropriate.** If your app or game needs sensitive data, use a field that obscures people’s input as they enter it, typically by displaying a small filled circle symbol for each character. For developer guidance, see [`SecureField`](https://developer.apple.com/documentation/SwiftUI/SecureField). In tvOS, you can also configure a [digit entry view](https://developer.apple.com/design/human-interface-guidelines/digit-entry-views) to obscure the numerals people enter (for developer guidance, see [`isSecureDigitEntry`](https://developer.apple.com/documentation/TVUIKit/TVDigitEntryViewController/isSecureDigitEntry)). When you use the system-provided text field in visionOS, the system shows the entered data to the wearer, but not to anyone else; for example, a secure text field automatically blurs when people use AirPlay to stream their content.
**Never prepopulate a password field.** Always ask people to enter their password or use biometric or keychain authentication. For guidance, see [Managing accounts](https://developer.apple.com/design/human-interface-guidelines/managing-accounts).
**When possible, offer choices instead of requiring text entry.** It’s usually easier and more efficient to choose from lists of options than to type information, even when a keyboard is conveniently available. When it makes sense, consider using a picker, menu, or other selection component to give people an easy way to provide the information you need.
**As much as possible, let people provide data by dragging and dropping it or by pasting it.** Supporting these interactions can ease data entry and make your experience feel more integrated with the rest of the system.
**Dynamically validate field values.** People can get frustrated when they have to go back and correct mistakes after filling out a lengthy form. When you verify values as soon as people enter them — and provide feedback as soon as you detect a problem — you give them the opportunity to correct errors right away. For numeric data, use locale-aware parsing and formatting; a formatter or numeric keyboard alone does not reject every invalid value, pasted input, nonfinite number or out-of-range amount. You can also configure a formatter to display the value in a specific way, such as with a certain number of decimal places, as a percentage, or as currency.
**When data entry is necessary, make sure people understand that they must provide the required data before they can proceed.** For example, if you include a Next or Continue button after a set of text fields, make the button available only after people enter the data you require.
## [Platform considerations](https://developer.apple.com/design/human-interface-guidelines/entering-data#Platform-considerations)
_No additional considerations for iOS, iPadOS, tvOS, visionOS, or watchOS._
### [macOS](https://developer.apple.com/design/human-interface-guidelines/entering-data#macOS)
**Consider using an expansion tooltip to show the full version of clipped or truncated text in a field.** An _expansion tooltip_ behaves like a regular tooltip, appearing when the pointer rests on top of a field. Apps running in macOS — including iOS and iPadOS apps running on a Mac — can use an expansion tooltip to help people view the complete data they entered when a text field is too small to display it. For guidance, see [Offering help > macOS, visionOS](https://developer.apple.com/design/human-interface-guidelines/offering-help#macOS-visionOS).
## [Resources](https://developer.apple.com/design/human-interface-guidelines/entering-data#Resources)
#### [Related](https://developer.apple.com/design/human-interface-guidelines/entering-data#Related)
[Text fields](https://developer.apple.com/design/human-interface-guidelines/text-fields)
[Virtual keyboards](https://developer.apple.com/design/human-interface-guidelines/virtual-keyboards)
[Keyboards](https://developer.apple.com/design/human-interface-guidelines/keyboards)
#### [Developer documentation](https://developer.apple.com/design/human-interface-guidelines/entering-data#Developer-documentation)
[Input events](https://developer.apple.com/documentation/SwiftUI/Input-events) — SwiftUI
#### [Videos](https://developer.apple.com/design/human-interface-guidelines/entering-data#Videos)
[ What's new in UIKit ](https://developer.apple.com/videos/play/wwdc2021/10059)
## [Change log](https://developer.apple.com/design/human-interface-guidelines/entering-data#Change-log)
Date| Changes
---|---
June 21, 2023| Updated to include guidance for visionOS.
## Implementation checks
Validate authoritative constraints on the server where relevant. Secure text entry masks display but does not encrypt transport/storage or justify logging secrets. Use supported Password AutoFill/passkeys; never prefill a stored plaintext password. Keep persistent labels and accessible error descriptions, and avoid announcing errors on every keystroke.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |