WidgetKit

Put your app's most useful information and actions right where people look.

Read the documentation Visit website WWDC sessions

Introduced

2020

WWDC20

Kind

Framework

Runs on

Get it from

iOS

14.0+

iPadOS

14.0+

Mac Catalyst

14.0+

macOS

11.0+

tvOS

visionOS

26.0+

watchOS

9.0+

A small Steps widget on the Home Screen.

Overview

WidgetKit builds widgets in SwiftUI from a timeline of entries, so they stay fresh without your app running. The same widget can appear on the Home Screen, Lock Screen, StandBy, the Mac desktop, Apple Watch and more.

Widgets can be interactive with App Intents, and controls bring your app's actions to Control Center, the Lock Screen and the Action button.

Everywhere

Home Screen, Lock Screen, StandBy, desktop and watch.

Interactive

Buttons and toggles powered by App Intents.

Controls

Actions in Control Center and on the Action button.

Timelines

Fresh content without your app running.

StepsWidget.swift

import SwiftUI
import WidgetKit

struct StepsWidget: Widget {
    var body: some WidgetConfiguration {
        StaticConfiguration(kind: "Steps", provider: StepsProvider()) { entry in
            Text("\(entry.steps) steps")
                .font(.title2.bold())
                .containerBackground(.fill.tertiary, for: .widget)
        }
        .configurationDisplayName("Steps")
        .supportedFamilies([.systemSmall, .accessoryRectangular])
    }
}

History