<!--
{
  "documentType" : "article",
  "framework" : "Xcode",
  "identifier" : "/documentation/Xcode/configuring-group-activities",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "Configuring Group Activities"
}
-->

# Configuring Group Activities

Leverage FaceTime infrastructure to create coordinated experiences users can
share.

## Overview

Use <doc://com.apple.documentation/documentation/GroupActivities> to bring your
app’s users together to enjoy new and exciting shared experiences that are
built atop [SharePlay](https://developer.apple.com/shareplay) and the FaceTime
infrastructure. For example, a karaoke app might offer karaoke parties where
several participants take part simultaneously from their own devices.

Represent shareable activities by creating objects that conform to the <doc://com.apple.documentation/documentation/GroupActivities/GroupActivity>
protocol and, after a shared activity begins, use <doc://com.apple.documentation/documentation/GroupActivities/GroupSession>
to synchronize that activity across participants’ devices.

### Add the Group Activities capability to your target

Follow the steps in [Add a capability](/documentation/Xcode/adding-capabilities-to-your-app#Add-a-capability) to
add the capability to your app’s target, making sure you select the Group
Activities capability from Xcode’s Capabilities library. This capability is
available on all platforms except watchOS, and you must add it to an app
target — Group Activities aren’t available in widgets, extensions, or App
Clips.

![A screenshot of Xcode’s Capabilities library with a list of available capabilities on the left and an information pane on the right. The list shows a range of capabilities from Group Activities to Maps, and the Group Activities capability is in a selected state. The text on the information pane explains that Group Activities allows an app to communicate with the same app on one or more other devices to create a group activity within a FaceTime call, and how Group Activities on FaceTime lets users watch video together, listen to music together, or enjoy another synchronous activity.](images/com.apple.Xcode/group-activities@2x.png)

After you add the Group Activities capability, Xcode updates your target’s
entitlements file to include the <doc://com.apple.documentation/documentation/BundleResources/Entitlements/com.apple.developer.group-session>
entitlement. If Xcode automatically manages the signing of your app, it also
enables Group Activities for your app’s App ID.

> Note: If you remove the Group Activities capability in Xcode, you must
> manually update your App ID’s configuration in your developer account to disable
> Group Activities.

When you add the Group Activities capability, there are additional steps you
must complete before your app’s users can start experiencing shared activities;
for more information on these steps, see <doc://com.apple.documentation/documentation/GroupActivities/defining-your-apps-shareplay-activities>
and <doc://com.apple.documentation/documentation/GroupActivities/joining-and-managing-a-shared-activity>.

---

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)