<!--
{
  "documentType" : "article",
  "framework" : "AppIntents",
  "identifier" : "/documentation/AppIntents/focus",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Focus"
}
-->

# Focus

Adjust your app’s behavior and filter incoming notifications when the
current Focus changes.

## Overview

![](images/com.apple.AppIntents/focus-filters-hero@2x.png)

People use Focus on macOS, iOS, and iPadOS to minimize distractions. For example,
someone might use a Work Focus to hide notifications from personal email
or message accounts. When someone engages a Focus, the system executes your
app’s custom [`SetFocusFilterIntent`](/documentation/AppIntents/SetFocusFilterIntent). Define a version of this intent to
update your app’s configuration and filter incoming notifications.

> Related sessions from WWDC22:
> Session 10121: [Meet Focus filters](https://developer.apple.com/videos/play/wwdc2022/10121).

## Topics

### Focus filters

[`SetFocusFilterIntent`](/documentation/AppIntents/SetFocusFilterIntent)

An interface for providing an app intent that you use to adapt your app’s behavior when Focus changes.

[Defining your app’s Focus filter](/documentation/AppIntents/defining-your-app-s-focus-filter)

Customize your app’s behavior to reflect the device’s current Focus.

[`FocusFilterAppContext`](/documentation/AppIntents/FocusFilterAppContext)

A type that contains app-specific contextual information for a particular Focus, such as the notification filter criteria to
apply.

[`FocusFilterSuggestionContext`](/documentation/AppIntents/FocusFilterSuggestionContext)

A type you use to suggest app configurations for a given Focus.

### Errors

[`SetFocusFilterIntentError`](/documentation/AppIntents/SetFocusFilterIntentError)

Errors that can occur when you try to retrieve the current Focus configuration settings.



---

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)