<!--
{
  "availability" : [
    "iOS: 9.0.0 -",
    "iPadOS: 9.0.0 -",
    "macOS: 10.11.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "BundleResources",
  "identifier" : "/documentation/BundleResources/Information-Property-List/NSIncludesSubdomains",
  "metadataVersion" : "0.1.0",
  "role" : "Property List Key",
  "symbol" : {
    "kind" : "Property List Key",
    "modules" : [
      "Bundle Resources"
    ],
    "preciseIdentifier" : "plist:Information_Property_List.NSIncludesSubdomains"
  },
  "title" : "NSIncludesSubdomains"
}
-->

# NSIncludesSubdomains

A Boolean value that indicates whether to extend the configuration to subdomains of the given domain.

## Discussion

You can include this key in any of the domain-specific dictionaries that you add to the [`NSExceptionDomains`](/documentation/BundleResources/Information-Property-List/NSAppTransportSecurity/NSExceptionDomains) and [`NSPinnedDomains`](/documentation/BundleResources/Information-Property-List/NSAppTransportSecurity/NSPinnedDomains) dictionaries. Adding the [`NSIncludesSubdomains`](/documentation/BundleResources/Information-Property-List/NSIncludesSubdomains) key affects the applicability of the other configuration in the same domain-specific dictionary. The key is optional, with a default value of `NO`.

Set the value for this key to `YES` to apply the configuration for the given domain to all subdomains of the domain that have one additional path component. For example, if you set this value to `YES` and the domain name string is `example.com`, then the configuration applies to `example.com`, as well as `math.example.com` and `history.example.com`. However, it doesn’t apply to the subdomains `advanced.math.example.com` or `ancient.history.example.com` because those subdomains have two additional path components. If the value is `NO` the configuration applies only to `example.com`.

If you create an [`NSExceptionDomains`](/documentation/BundleResources/Information-Property-List/NSAppTransportSecurity/NSExceptionDomains) dictionary for an IP address or a range of addresses, the [`NSIncludesSubdomains`](/documentation/BundleResources/Information-Property-List/NSIncludesSubdomains) key has no effect for that exception.

## See Also

[`NSExceptionDomains`](/documentation/BundleResources/Information-Property-List/NSAppTransportSecurity/NSExceptionDomains)

Custom App Transport Security (ATS) configurations for named domains.

[`NSPinnedDomains`](/documentation/BundleResources/Information-Property-List/NSAppTransportSecurity/NSPinnedDomains)

A collection of certificates that App Transport Security expects when connecting to named domains.


---

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)