Generate promotional codes

Partner Center lets you generate promotional codes for an app or add-on that you have published in the Microsoft Store. Promotional codes are an easy way to give influential users free access to your app or add-on. You might also use promotional codes to address customer service scenarios by giving users free access to your app or add-on, or for beta testing.

Each promotional code has a corresponding unique redeemable URL that a customer can click in order to redeem the code and install your app or add-on from the Microsoft Store. Note that your app must pass the final publishing phase of the app certification process before customers can redeem a promotional code to install it.

You can generate single-use codes (and distribute one to each customer), or you can choose to generate a code that can be used multiple times by a specified number of customers.

Be aware of the following policies for promotional codes:

• You can generate promotional codes for any app or add-on (with the exception of subscription add-ons) that you have published to the Microsoft Store. Customers can redeem the codes on any version of Windows that is supported by your app or add-on.
• For games:
  • You can generate up to 5000 promotional codes per game.
  • Promotional codes generated for games never expire.
• For all other types of apps or add-ons:
  • In any six-month period, you may generate up to 1600 single-use promotional codes, or any number of multiple-use codes such that the total allowed redemptions does not exceed 1600.
  • The 6 month period begins when you generate the first promotional code and lasts for 6 months regardless of whether or not you set an earlier expiration date on the codes.
  • Any codes created during an existing 6 month period will count toward the number of codes generated within that period, even if they will expire after the period ends. For example, if you generate a code on the last day of the six-month window, it will be will be still be valid for a full 6 months from its creation.
• You must follow the requirements defined in the App Developer Agreement, including section 3k. Promotional Codes.

To order promotional codes for an app or add-on:

1. In the left navigation menu of Partner Center, expand Attract and then select Promo codes.

2. On the Promotional codes page, click Order codes.

3. On the New promotional codes order page, enter the following:

   • Select the app or add-on for which you want to generate codes. (Note that you can't generate promotional codes for subscription add-ons.)
   • Specify a name for the order. You can use this name to differentiate between different orders of codes when reviewing your promotional code usage data.
   • Select the order type. You can choose to generate a set of promo codes that can each be used once, or you can choose to generate one promo code that can be used multiple times.
   • Specify the number of codes to order (if generating a set of codes) or the number of times the code can be redeemed (if generating one code to be used multiple times).
   • Specify when the promotional codes should become active. To choose a specific start date and time, clear the Codes are active immediately check box. Otherwise, the codes will become active right away (although your product must have completed the publishing process in order for a customer to use the code).
   • Specify when the promotional codes should expire. To choose a specific expire date and time earlier than 6 months, clear the Codes expire after 6 months check box.

4. Click Order codes. You'll then be returned to the Promotional codes page, where you'll be able to see your new order in the summary table of promotional code orders for that app.

To download a fulfilled promotional code order and distribute the codes to customers:

1. In the left navigation menu of Partner Center, expand Attract and then select Promo codes.

2. Click the Download link for the promotional code order, then save the generated file to your computer. This file contains information about your promotional codes order in tab-separated value (.tsv) format.

3. Open the .tsv file in the editor of your choice. For the best experience, open the .tsv file in an application that can display the data in a tabular structure, such as Microsoft Excel. However, you can open the file in any text editor.

   The file contains the following columns of data for each code:

   • Product name: The name of the app or add-on that the code is associated with.
   • Order name: The name of the order in which this code was generated.
   • Promotional code: The code itself. This is a 5x5 string of alphanumeric characters separated by hyphens. For example: DM3GY-M2GYM-6YMW6-4QHHT-23W2Z
   • Redeemable URL: The URL that a customer can use to redeem the code and install your app or add-on. The URL has the following format: https://go.microsoft.com/fwlink/?LinkId=532540&mstoken=<promotional_code>
   • Start date: The date this code became active.
   • Expire date: The date this code expires.
   • Code ID: A unique ID for this code.
   • Order ID: A unique ID for the order in which this code was generated.
   • Given to: An empty field that you can use to keep track of which customer you gave the code to.
   • Available: The number of times the code is still available to redeem (at the time the file was generated).
   • Redeemed: The number of times that the code has been redeemed (at the time the file was generated).

4. Distribute the redeemable URLs to your customers via any communication format you prefer (for example targeted notifications, email, SMS messages, or printed cards). We recommend that your communication includes the following:

   • An explanation of which app or add-on the promotional code is for, and optionally a description of why the customer is receiving the code.
   • The redeemable URL for the code.
   • Instructions that guide the customer to visit the redeemable URL, log in using their Microsoft account, and follow the instructions to download and install your app.

After you distribute a promotional code (or its redeemable URL) to a customer, they can click the URL to get the product for free. Clicking the redeemable URL will launch an authenticated Redeem your code page at https://account.microsoft.com/billing/redeem. This page includes a description of the app the user is about to redeem. If the customer is not logged in with their Microsoft account, they may be prompted to do so. Your customer can also visit https://account.microsoft.com/billing/redeem and enter the code directly.

After the customer clicks Redeem, the Microsoft Store will open to the overview page for the app (if they are on a Windows 10 or Windows 11 device), where they can click Install to download and install the app for free. If the customer is on a computer or device that does not have the Microsoft Store installed, the link will launch the Microsoft Store web page for the app. The code will be applied to the customer's Microsoft account, so they can later download the app on a Windows device (that is associated with the same Microsoft account) for free.

To review a detailed summary of promotional code orders for your apps and add-ons, navigate to the Promotional codes page (in the left navigation menu of Partner Center, expand Attract and then select Promo codes). You can review the following details for all of your current and inactive promotional codes:

• Order name
• App or add-on
• Start date
• Expire date
• Available
• Redeemed

You can also download an order from this table.

When you convert your current Win32 application into an MSIX package for Store distribution, you have the option to distribute promotional codes via email to your current users. This enables them to seamlessly migrate to your packaged app while retaining access to the features obtained through their initial purchase.