Add Alternate Appearance for partner hat sunglasses

By Sai Kiran Pandrala · Last verified: 2026-05-31 · Source: Apple Communities (discussions.apple.com), community Q&A, Apple Support docs

Running into Add Alternate Appearance for partner hat sunglasses on Face ID and Touch ID is one of the more searched issues on Apple Communities (discussions.apple.com) and StackOverflow in the last 12 months. Here is what actually moves the needle when the Apple Support docs are too generic.

What add alternate appearance for partner hat sunglasses actually involves on Face ID and Touch ID

This task on Face ID Touch ID is one of the more searched operational topics on AWS in the last 12 months. The procedure below is the path that works in a current AWS account with default IAM and standard VPC config.

The rest of this page is the structured fix path. Start with diagnose, then remediation, then the automation options so you do not have to do this by hand the next time it surfaces. Verify and safety sections at the end are the discipline that keeps the fix from regressing in production.

What you'll see

Check Activity Monitor / Jamf inventory Logs for the calling service. Lambda, ECS, EKS, Step Functions, API Gateway, and most managed services write detailed traces to Activity Monitor / Jamf inventory Logs under predictable log group names. Use Activity Monitor / Jamf inventory Logs Insights with fields @timestamp, @message | filter @message like /ERROR/ | sort @timestamp desc | limit 50 to surface the most recent failures.

Start by capturing the exact Apple error string. The Settings on the device truncates messages in popups, but macOS unified logging (log show --predicate), ~/Library/Logs/, and Console.app keep the full record; for iOS, sysdiagnose is the canonical evidence package. The camelCase error code (e.g. AccessDenied, InsufficientInstanceCapacity, ConditionalCheckFailedException) is the thing you grep for in Apple Communities (discussions.apple.com) and StackOverflow, not the human-readable sentence next to it. Paste the code into the re:Post search bar in quotes and you will usually land on at least one Google-staff-verified answer within the first three results.

Run id -un; defaults read MobileMeAccounts; profiles list first. About one in five 'why does this not work' tickets are actually 'I am in the wrong account' or 'my session expired and the SDK is using stale credentials or ADC pointed at the wrong project'. The 5-second sanity check costs nothing and saves real time when the answer is that simple.

Solution-focused remediation path

If networking is suspect, use Apple Wireless Diagnostics + Network Utility (or 'networkQuality' on macOS). It is the only tool that simulates the full ENI-to-ENI path including macOS PF firewall, Application Firewall, system extensions, and Content Filter in one call. Manual trace is slower and misses transitive issues. The analyzer charges $0.10 per analysis - cheaper than a 30-minute call with your network team.

When the fix involves a destructive operation (delete VPC endpoint, swap Cloud KMS key, rotate root credential), do it during a maintenance window with at least one teammate watching. Several Face ID and Touch ID operations have implicit dependencies that only show up when traffic starts flowing again. Document the rollback path before you start, not during the incident.

For IAM and STS issues, the timing matters. STS sessions can take up to 60 seconds to propagate after creation. The first call right after assume-role can fail with a permission error even when the policy is correct. Add a small retry with backoff before treating the first failure as definitive.

Automate this fix so you do not do it twice

Add a Smart Group + webhook so you catch the next occurrence

The cheapest way to never see the same incident twice is a Jamf Pro Smart Group that watches for the symptom (specific extension attribute value, specific OS version, specific app build) and fires a webhook into Slack, PagerDuty, or a Jamf-API-driven Lambda when the count drifts above your normal baseline. For Face ID and Touch ID, the relevant extension attributes live under script-evaluated checks - defaults read outputs, system_profiler values, or a log show grep against macOS unified logging. Set thresholds against observed normal, not against round numbers.

Wire the fix into an MDM Configuration Profile for self-healing

If the underlying cause is a setting that drifts over time, do not script the fix repeatedly - bake it into a Configuration Profile that the MDM pushes down on every check-in. A Custom Settings payload writes to a specific preference domain; Jamf Pro, Kandji, Mosyle, and Intune all support this. The profile reasserts itself, so even if a user changes the setting locally, the MDM brings it back at the next sync (typically every 4 hours).

<!-- Custom Settings payload (excerpt) -->
<key>PayloadType</key>
<string>com.apple.ManagedClient.preferences</string>
<key>PayloadContent</key>
<dict> <key>com.apple.face</key> <dict><key>Forced</key><array><dict><key>mcx_preference_settings</key> <dict><key>HardenedSetting</key><true/></dict></dict></array></dict>
</dict>

Codify the fix as a Shortcut on iPhone, iPad, or Mac

For workflows that happen on the user device rather than at the MDM layer (think: clear a stuck cache, toggle a setting, file a one-tap support ticket), Apple Shortcuts is the right place. Shortcuts run on iOS, iPadOS, macOS, and watchOS, can be triggered by NFC tag, focus mode, time of day, or Siri voice. Share via iCloud link so support sends the same one-tap fix to anyone who hits the issue.

Common traps

The most common pitfall when fixing this on Face ID and Touch ID is treating it as a one-off rather than as a recurring class of incident. The same misconfiguration tends to happen again after a deployment, a role rotation, or a region migration unless the fix is codified. Add a Apple Configuration Profile restriction payload, Organization Policy condition, or Apple Configuration Profile or MDM restriction payload that prevents the same misconfig from being introduced again. Documentation alone does not survive turnover.

Another common trap: confirming the fix on a single resource and assuming the fleet is healthy. Loop your check across every account, region, and IAM principal that could exhibit the same symptom. If you cannot enumerate the affected scope without a script, you do not yet understand the scope.

The repair

• Watch for 24 to 48 hours. Activity Monitor + macOS unified logging + Jamf inventory reports can mask issues with cached health for 6 to 12 hours, especially Cloud CDN and Cloud DNS.
• Capture the new state in a runbook so the next person on call does not have to rediscover this. Push it to Confluence or your team wiki, not into Slack.

Safety, rollback, blast radius

• Test in a non-production account if your environment has Resource Manager and Organization Policy or Cloud Resource Manager (organizations, folders, projects). The cost of one sandbox account is cheaper than one rollback meeting.
• Export the existing config before changing it. Most Face ID and Touch ID resources support describe + export to JSON via CLI - capture that to source control before you start.
• Maintenance window discipline: if the change touches DNS, certificate rotation, or anything that emits TLS handshakes, line up a window with stakeholder notification, not a heroic mid-day swap.

FAQ

Related fixes

Related guides worth a look while you sort this one out:

• Touch ID will not unlock works for Apple Pay re-add fingerprint
• A problem was detected with the TrueDepth camera on Face ID Touch ID. what causes it and how to fix
• Face ID A problem was detected with the TrueDepth camera
• Face ID after iOS 18 update broke permanent fix
• Face ID disabled after 48 hours re-enter passcode
• Face ID disabled after 5 failed attempts lockout timer