---
title: Associated Domains Entitlement
framework: Bundle Resources
role: symbol
role_heading: Property List Key
platforms: [iOS 9.0+, iPadOS 9.0+, Mac Catalyst 9.0+, macOS 10.15+, tvOS 9.0+, visionOS 1.0+, watchOS 6.0+]
path: bundleresources/entitlements/com_apple_developer_associated-domains
---

# Associated Domains Entitlement

The associated domains for specific services, such as shared web credentials, universal links, and App Clips.

## Discussion

This key specifies a list of domains for each enabled service. Add an associated domain to the list in the following format:

```swift
<service>:<fully qualified domain>
```

Services include:

> **note:** In macOS 11 and later and iOS 14 and later, apps request `apple-app-site-association` files from an Apple-managed content delivery network (CDN) specifically for associated domains, instead of directly from your web server. If the CDN has an old version of the file, or doesn’t already have a copy of the file, it connects to your web server to obtain the latest version.

If you use a private web server, which is unreachable from the public internet, while developing your app, enable the alternate mode feature to bypass the CDN and connect directly to your server. To do this, add a query string to your associated domains entitlement, as shown in the following example:

```console
<service>:<fully qualified domain>?mode=<alternate mode>
```

Where `alternate mode` is one of the following:

To enable associated domains, add the Associated Domains capability to your target in Xcode. For more information, see [Adding capabilities to your app](../../xcode/adding-capabilities-to-your-app.md).

> **important:** For watchOS apps, you must add the Associated Domains capability to the WatchKit Extension target.

## See Also

### Related Documentation

- [Supporting associated domains](../../xcode/supporting-associated-domains.md)
- [Creating an App Clip with Xcode](../../appclip/creating-an-app-clip-with-xcode.md)

### Networking

- [Network Extensions Entitlement](com.apple.developer.networking.networkextension.md)
- [Personal VPN Entitlement](com.apple.developer.networking.vpn.api.md)
- [com.apple.developer.networking.multicast](com.apple.developer.networking.multicast.md)
- [com.apple.developer.associated-domains.applinks.read-write](com.apple.developer.associated-domains.applinks.read-write.md)
- [com.apple.developer.networking.manage-thread-network-credentials](com.apple.developer.networking.manage-thread-network-credentials.md)
- [5G Network Slicing App Category](com.apple.developer.networking.slicing.appcategory.md)
- [5G Network Slicing Traffic Category](com.apple.developer.networking.slicing.trafficcategory.md)
- [com.apple.developer.networking.vmnet](com.apple.developer.networking.vmnet.md)
- [Configuring your app for ultra-constrained networks](../configuring-your-app-for-ultra-constrained-networks.md)
- [com.apple.developer.networking.carrier-constrained.appcategory](com.apple.developer.networking.carrier-constrained.appcategory.md)
- [com.apple.developer.networking.carrier-constrained.app-optimized](com.apple.developer.networking.carrier-constrained.app-optimized.md)