Understanding the anatomy of a Today Extension

The terms Today Extension and widget can be used interchangeably; they both refer to a component that is present in iOS's Today View. In this chapter, the term widget isĀ used throughout.

If you swipe down from the top of the screen to open Spotlight and swipe right after that, you're presented with the Today View. On the simulator, this view tends to look rather empty, but on your device, there's probably a lot more going on. The following screenshot shows the Today View on the simulator with a couple of widgets added to it:

Users can scroll to the bottom of this view and manage their widgets from there. They can add new widgets and remove existing ones. All these widgets have one thing in common: they provide relevant information for the current moment or day. For the Calendar, this means showing events that you have planned for today or tomorrow. The Favorites widget in the screenshot usually contains contacts that the user interacts with often. Users can even add a widget that suggests apps that the user is likely to use based on the current time and the user's location.

Any widget that you implement for your app should aim to provide your users with relevant, easy-to-scan information. Doing this makes your widget more useful and more likely to be added to a user's Today View.

Before you implement your own Today Extension, let's take a closer look at how a Today Extension works and where a user can find them in iOS.