> ## Documentation Index
> Fetch the complete documentation index at: https://docs.median.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Building an iOS binary with App Groups entitlement

> Configure App Groups for your iOS build.

An App Group lets your main app share a common data container with its extensions: for example, a Share Extension, a Today widget, or an App Clip that needs access to the same data as the main app.

If your app includes any of these, you'll need to enable the App Groups entitlement before building. All configuration in this article is performed in the Apple Developer Portal, not in Median directly.

## Prerequisites

* Your Bundle ID must already be registered (see [Configure signing for your app](https://docs.median.co/docs/configure-signing-for-your-app.md))
* Admin or App Manager access to your Apple Developer account

## App group configuration

### Step 1: Create an app group

1. Sign in to [Apple Developer → Identifiers](https://developer.apple.com/account/resources/identifiers/list) in Apple Developer (not App Store Connect).
2. Change the filter at the top from App IDs to App Groups.
3. Click + to create a new App Group.

![Identifiers list in the Apple Developer Portal filtered to App Groups](https://mintcdn.com/median-co/TpSItjrYpkPK-i0N/images/docs/9b6cc851f3badd5dfb1b12bbcb45bee9406288caa6a25756b9334ed2384e76a7-Screenshot_2026-07-06_at_10.58.17.png?fit=max\&auto=format\&n=TpSItjrYpkPK-i0N\&q=85\&s=a37ac3bfbbd7f9a42de846f1f98656f5)

Apple Developer: Identifiers

4. Enter a **Description** and an **Identifier**. The identifier must start with `group.` (for example, `group.com.company.app`).
5. Click **Continue**, then **Register**.

![App Group registration form with description and identifier fields](https://mintcdn.com/median-co/yvThAkXSLqPa6nzP/images/docs/f2db31cd63b32af63babbb1db0e272642424928658b37bd8f2d4dc0232010001-Screenshot_2026-07-06_at_11.00.50.png?fit=max\&auto=format\&n=yvThAkXSLqPa6nzP\&q=85\&s=cbe6fd947655ec4b0e3f5aef7c788768)

App Group registration

### Step 2: Enable app groups for the main application

1. Still under Identifiers, switch the filter back to App IDs and select your app's existing Bundle ID.

![App IDs list in the Apple Developer Portal](https://mintcdn.com/median-co/TpSItjrYpkPK-i0N/images/docs/b15f4bb72c67985ccad8bc27e9f5f6c1a4e0d38f63bbc5dfd475ad0203103f0a-Screenshot_2026-07-06_at_11.01.56.png?fit=max\&auto=format\&n=TpSItjrYpkPK-i0N\&q=85\&s=c92a7214487ed1d964bb3bb1987b65eb)

Apple Developer Portal: App IDs

2. Locate and select the main application’s bundle identifier (for example, `com.example.app`).
3. Scroll to the Capabilities section and enable App Groups.

![App Groups capability enabled for the App ID](https://mintcdn.com/median-co/7LCOHMhgIef7ewYE/images/docs/71f6b2c69bba8222bd7aff9a978cf993989cc7d9f87f377837edc04485746af0-Screenshot_2026-07-06_at_11.03.16.png?fit=max\&auto=format\&n=7LCOHMhgIef7ewYE\&q=85\&s=6b2544b5fbbe8f3728d3c33d49401d6c)

App Group enablement

4. Click **Configure** and select the App Group created in Step 1.

![App Group from Step 1 selected in the App Groups configuration dialog](https://mintcdn.com/median-co/7LCOHMhgIef7ewYE/images/docs/53db3d520841783802fceb3121bf98fc6a4092ed9c1e7011455733e93c73b3f8-Screenshot_2026-07-06_at_11.03.57.png?fit=max\&auto=format\&n=7LCOHMhgIef7ewYE\&q=85\&s=fe42e9f9420e8fb9474b01fba35bae7c)

App Group addition

### Step 3: Regenerate your provisioning profile

1. Repeat the steps in Step 2 for each extension that requires access to the shared container (for example, `com.example.app.ShareExtension`).

2. Edit the profile (or create a new one if editing isn't available) so it regenerates against the updated Bundle ID. The App Groups entitlement is only included in profiles created after the capability was enabled.

   **Important**: Every target that uses shared data must have the same App Group enabled in its App ID configuration.

### Step 4: Rebuild

After enabling the App Group capability:

1. In Median App Studio, go to your app's iOS IPA Build Configuration panel and rebuild the app so Median adds the updated entitlement.

![Regenerating the provisioning profile with the App Groups entitlement](https://mintcdn.com/median-co/TpSItjrYpkPK-i0N/images/docs/aedc71a12c62cc4628fd04727b75c63b874223991254acfe08652e4cdb1c9b07-Screenshot_2026-07-06_at_11.07.38.png?fit=max\&auto=format\&n=TpSItjrYpkPK-i0N\&q=85\&s=d10f21e0cdb8e2ec3f14c0c1cdb83e07)

Provisioning profile regeneration

2. Distribute the iOS binary.

## Verification checklist

Before distributing the app or reporting an issue, please confirm:

* [ ] The App Group identifier begins with `group.`

* [ ] App Groups is enabled on the main app's Bundle ID

* [ ] App Groups is enabled on every extension's Bundle ID that needs shared access

* [ ] The provisioning profile was regenerated after enabling App Groups (not just re-downloaded)

* [ ] Median's build used the newly regenerated profile, not a cached one


## Related topics

- [Building an iOS binary (IPA)](https://docs.median.co/docs/build-ios-binary.md)
- [Share into app](https://docs.median.co/docs/share-into-app.md)
- [Build iOS from source](https://docs.median.co/docs/build-ios-from-source.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.