---
title: GroupActivityMetadata
framework: groupactivities
role: symbol
role_heading: Structure
path: groupactivities/groupactivitymetadata
---

# GroupActivityMetadata

Text and image content that describes an activity to potential participants.

## Declaration

```swift
struct GroupActivityMetadata
```

## Mentioned in

Defining your app’s SharePlay activities Adding spatial Persona support to an activity

## Overview

Overview Use a GroupActivityMetadata structure to store user-facing information about a specific activity your app suggests. Metadata information includes the title of the activity, an image that corresponds to the activity, and a fallback URL for users who don’t have your app. For example, a movie-watching activity might include the poster of the specific movie a participant suggests. The system uses the provided metadata to generate invitations for other participants. Create a GroupActivityMetadata structure in the metadata property of your custom GroupActivity subclass. Populate the new structure with the relevant data for your activity.

## Topics

### Creating group activity metadata

- [init()](groupactivities/groupactivitymetadata/init().md)

### Presenting the activity

- [title](groupactivities/groupactivitymetadata/title.md)
- [subtitle](groupactivities/groupactivitymetadata/subtitle.md)
- [previewImage](groupactivities/groupactivitymetadata/previewimage.md)
- [fallbackURL](groupactivities/groupactivitymetadata/fallbackurl.md)

### Indicating the activity’s type

- [type](groupactivities/groupactivitymetadata/type.md)
- [GroupActivityMetadata.ActivityType](groupactivities/groupactivitymetadata/activitytype.md)

### Assigning an app-specific scene

- [sceneAssociationBehavior](groupactivities/groupactivitymetadata/sceneassociationbehavior.md)
- [SceneAssociationBehavior](groupactivities/sceneassociationbehavior.md)

### Specifying media-related behavior

- [supportsContinuationOnTV](groupactivities/groupactivitymetadata/supportscontinuationontv.md)
- [preferredBroadcastOptions](groupactivities/groupactivitymetadata/preferredbroadcastoptions.md)
- [BroadcastOptions](groupactivities/broadcastoptions.md)

### Structures

- [GroupActivityMetadata.LifetimePolicy](groupactivities/groupactivitymetadata/lifetimepolicy-swift.struct.md)

### Instance Properties

- [experience](groupactivities/groupactivitymetadata/experience-swift.property.md)
- [lifetimePolicy](groupactivities/groupactivitymetadata/lifetimepolicy-swift.property.md)
- [localizedSubtitle](groupactivities/groupactivitymetadata/localizedsubtitle.md)
- [localizedTitle](groupactivities/groupactivitymetadata/localizedtitle.md)

### Enumerations

- [GroupActivityMetadata.Experience](groupactivities/groupactivitymetadata/experience-swift.enum.md)

## Relationships

### Conforms To

- [Copyable](swift/copyable.md)
- [Decodable](swift/decodable.md)
- [Encodable](swift/encodable.md)
- [Equatable](swift/equatable.md)
- [Escapable](swift/escapable.md)
- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)

## See Also

### Activity definition

- [Defining your app’s SharePlay activities](groupactivities/defining-your-apps-shareplay-activities.md)
- [Supporting coordinated media playback](avfoundation/supporting-coordinated-media-playback.md)
- [GroupActivity](groupactivities/groupactivity.md)
- [GroupActivityActivationResult](groupactivities/groupactivityactivationresult.md)
- [GroupActivityTransferRepresentation](groupactivities/groupactivitytransferrepresentation.md)