<!--
{
  "availability" : [
    "iOS: 17.5.0 -",
    "iPadOS: 17.5.0 -",
    "macCatalyst: 17.5.0 -",
    "macOS: 14.5.0 -",
    "tvOS: 17.5.0 -",
    "visionOS: 1.2.0 -",
    "watchOS: 10.5.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "BundleResources",
  "identifier" : "/documentation/BundleResources/Information-Property-List/SKExternalPurchaseMultiLink",
  "metadataVersion" : "0.1.0",
  "role" : "Property List Key",
  "symbol" : {
    "kind" : "Property List Key",
    "modules" : [
      "Bundle Resources"
    ],
    "preciseIdentifier" : "plist:Information_Property_List.SKExternalPurchaseMultiLink"
  },
  "title" : "SKExternalPurchaseMultiLink"
}
-->

# SKExternalPurchaseMultiLink

A dictionary that contains an array of URLs to websites where people using your app can make external purchases.

## Discussion

Use this information property list key if your app has the [`com.apple.developer.storekit.external-purchase-link`](/documentation/BundleResources/Entitlements/com.apple.developer.storekit.external-purchase-link) entitlement.

The keys for this dictionary are lowercased ISO 3166-1 alpha-2 country codes.
Valid country codes include those for the European Union: Austria (`at`), Belgium (`be`), Bulgaria (`bg`), Croatia (`hr`), Cyprus (`cy`), Czechia (`cz`), Denmark (`dk`), Estonia (`ee`), Finland (`fi`), France (`fr`), Germany (`de`), Greece (`gr`), Hungary (`hu`), Ireland (`ie`), Italy (`it`), Latvia (`lv`), Lithuania (`lt`), Luxembourg (`lu`), Malta (`mt`), Netherlands (`nl`), Poland (`pl`), Portugal (`pt`), Romania (`ro`), Slovakia (`sk`), Slovenia (`si`), Spain (`es`), Sweden (`se`); and Iceland (`is`), Norway (`no`), and Russia (`ru`).

Include a key entry for each country code where your app supports an external purchase link. Provide from one to five destination URLs (links to your website) for your app to choose from for each country code.

> Note:
> You can provide one or more links if your app qualifies for the StoreKit External Purchase Link entitlement as described in [Distributing music streaming apps in the EEA that provide an external purchase link](https://developer.apple.com/support/music-streaming-services-entitlement-eea/).  Otherwise, provide one link for each country code.

Your app accesses these URLs through the <doc://com.apple.documentation/documentation/StoreKit/ExternalPurchaseLink/eligibleURLs> array in the <doc://com.apple.documentation/documentation/StoreKit/ExternalPurchaseLink> object, and uses the link you select with the <doc://com.apple.documentation/documentation/StoreKit/ExternalPurchaseLink/open(url:)> method in the <doc://com.apple.documentation/documentation/StoreKit/ExternalPurchaseLink> object.

> Important:
> At all times, the destination URLs that you provide in the property list key must match the values in your app binary that you submit to App Review.

Make sure each destination URL meets all of the following conditions:

- Uses the HTTPS scheme
- Forms a valid, absolute URL
- Contains no query parameters
- Contains 1,000 or fewer ASCII characters

The following code example shows a property list entry with keys for several country codes, and links for each entry:

```xml
<key>SKExternalPurchaseMultiLink</key>
<dict>
    <key>es</key>
    <array>
        <string>https://www.example.com/es1</string>
        <string>https://www.example.com/new-user-es</string>
        <string>https://www.example.com/seasonal-sale-es</string>
        <string>https://www.example.com/es2</string>
        <string>https://www.example.com/es3</string>
    </array>
    <key>fr</key>
    <array>
        <string>https://www.example.com/fr</string>
        <string>https://www.example.com/global-sale</string>
        <string>https://www.example.com/new-user-fr</string>
    </array>
    <key>it</key>
    <array>
        <string>https://www.example.com/global-sale</string>
    </array>
</dict>
```

The order of the links is not significant.

For more information, see <doc://com.apple.documentation/documentation/StoreKit/external-purchase> and <doc://com.apple.documentation/documentation/StoreKit/ExternalPurchaseLink>.

### Provide up to the maximum number of links

The following country codes have a maximum of five links for apps that qualify for the StoreKit External Purchase Link entitlement as described in [Distributing music streaming apps in the EEA that provide an external purchase link](https://developer.apple.com/support/music-streaming-services-entitlement-eea/): Austria (`at`), Belgium (`be`), Bulgaria (`bg`), Croatia (`hr`), Cyprus (`cy`), Czechia (`cz`), Denmark (`dk`), Estonia (`ee`), Finland (`fi`), France (`fr`), Germany (`de`), Greece (`gr`), Hungary (`hu`), Ireland (`ie`), Italy (`it`), Latvia (`lv`), Lithuania (`lt`), Luxembourg (`lu`), Malta (`mt`), Netherlands (`nl`), Poland (`pl`), Portugal (`pt`), Romania (`ro`), Slovakia (`sk`), Slovenia (`si`), Spain (`es`), Sweden (`se`), Iceland (`is`), Norway (`no`). Otherwise, the maximum is one link, for valid country codes.

Count the total number of unique links you provide for each country code by adding together the number of links you provide in the [`SKExternalPurchaseMultiLink`](/documentation/BundleResources/Information-Property-List/SKExternalPurchaseMultiLink) and [`SKExternalPurchaseLink`](/documentation/BundleResources/Information-Property-List/SKExternalPurchaseLink) property list keys.

For example, if a country code has a maximum of five links and you provide five unique links in the [`SKExternalPurchaseMultiLink`](/documentation/BundleResources/Information-Property-List/SKExternalPurchaseMultiLink) key, then specify one of the same five links in the [`SKExternalPurchaseLink`](/documentation/BundleResources/Information-Property-List/SKExternalPurchaseLink) key to avoid exceeding the maximum allowed links.  If a country code has a maximum of one link, the [`SKExternalPurchaseMultiLink`](/documentation/BundleResources/Information-Property-List/SKExternalPurchaseMultiLink) and [`SKExternalPurchaseLink`](/documentation/BundleResources/Information-Property-List/SKExternalPurchaseLink) keys need to specify the same link.

---

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)