---
title: ActivityFamily
framework: widgetkit
role: symbol
role_heading: Enumeration
path: widgetkit/activityfamily
---

# ActivityFamily

A family that defines the Live Activity’s size.

## Declaration

```swift
enum ActivityFamily
```

## Overview

Overview Live Activities support one or more sizes, giving you the flexibility to configure them for different devices. A Live Activity renders for a specific family, depending on both the device and the location in which it’s displayed. A Live Activity initiated on one device can be sent to a remote device that renders the Live Activity at a different family size. For example, if your Live Activity is running on an iOS or iPadOS device, it natively renders with an ActivityFamily.medium family. If you want to opt in to customize the rendering for a Live Activity for the watchOS Smart Stack, use the ActivityFamily.small family modifier. When you define your Live Activity’s configuration, specify the sizes your Live Activity supports using the supplementalActivityFamilies(_:) property modifier. When you render the content of the Live Activity, use activityFamily to read the current family and lay out your content appropriately. The code below uses supplementalActivityFamilies(_:) to specify the size of the Live Activity for devices on iOS and watchOS. // A RideSharingActivity that supports the watchOS Smart Stack and the iOS Lock Screen. struct RideSharingActivity: Widget {    var body: some WidgetConfiguration {        ActivityConfiguration(for: RideAttributes.self) { context in            RideSharingView(context: context)        } dynamicIsland: { context in            DynamicIsland {                DynamicIslandExpandedRegion(.bottom) {                    RideShareDetails()                }            } compactLeading: {                AppLogo()            } compactTrailing: {                ETAView()            } minimal: {                ETAView()            }        }        .supplementalActivityFamilies([.small, .medium])    } }

## Topics

### Accessing system families

- [ActivityFamily.small](widgetkit/activityfamily/small.md)
- [ActivityFamily.medium](widgetkit/activityfamily/medium.md)

### Environment keys

- [SupportedActivityFamiliesEnvironmentKey](widgetkit/supportedactivityfamiliesenvironmentkey.md)

## Relationships

### Conforms To

- [Copyable](swift/copyable.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Decodable](swift/decodable.md)
- [Encodable](swift/encodable.md)
- [Equatable](swift/equatable.md)
- [Escapable](swift/escapable.md)
- [Hashable](swift/hashable.md)
- [RawRepresentable](swift/rawrepresentable.md)

## See Also

### Live Activity setup

- [Displaying live data with Live Activities](activitykit/displaying-live-data-with-live-activities.md)
- [ActivityKit](activitykit.md)
- [Creating a widget extension](widgetkit/creating-a-widget-extension.md)
- [Emoji Rangers: Supporting Live Activities, interactivity, and animations](widgetkit/emoji-rangers-supporting-live-activities-interactivity-and-animations.md)
- [ActivityConfiguration](widgetkit/activityconfiguration.md)
- [DynamicIsland](widgetkit/dynamicisland.md)
- [NSUserActivityTypeLiveActivity](widgetkit/nsuseractivitytypeliveactivity.md)
- [ActivityPreviewViewKind](widgetkit/activitypreviewviewkind.md)