# MarketplaceKitURIScheme A URI scheme that defines an alternative distribution app installation link. ``` let MarketplaceKitURIScheme: String ``` ## Discussion This installation scheme defines how your webpage requests the installation of your app. For example, assign a URL with the following scheme to a Download button on your page: ``` marketplace-kit://install ?alternativeDistributionPackage= &installVerificationToken= &token= &account= &appShareURL=; ``` The URL parameters are: |URL parameter |Description | |--------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |`alternativeDistributionPackage`|Your app’s alternative distribution package in the assembled format described in . | |`installVerificationToken` |A required JSON web signature (JWS). For more information, see . | |`token` |An optional authentication token to include if downloads require authorization. iOS sends the token back to your token endpoint to reference this request. The value is free-form, and can contain any information at your discretion, such as an id that identifies the customer. | |`account` |An optional user ID for the page visitor. iOS groups apps in restore requests based on `account`. iOS also provides the `account` as `login_hint` for the authorization call during interactive re-authentication; for more information, see .| |`appShareURL` |An optional URL to a product landing page for the app on your marketplace website. The operating system populates the value in the Share Sheet when a person touches and holds the app’s icon on the Home Screen. | Web browsers recognize the scheme and hand off the installation request to [`MarketplaceKit`](/documentation/MarketplaceKit). For more information, see [Installing your app from your website](/documentation/marketplacekit/installing-your-app-from-your-website). ## Setting the alternative distribution package parameter The fully qualified domain in the `alternateDistributionPackage` value needs to match the fully qualified domain of the *referrer*, that is, the page that contains the `marketplace-kit://` link. This domain also needs to match the domain you supply to App Store Connect. For more information, see . For example: - Domain in App Store Connect: `mydomain.com` - Your webpage root domain: `mymarketplace.mydomain.com` - `alternateDistributionPackage` value: `https://mymarketplace.mydomain.com/path` > Note: To allow installation, the web browser also needs to support the app installation URL scheme. If you develop a browser app, see for more information. --- Copyright © 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)