Create an app submission for your add-on

An add-on must be associated with an app that you've created in Partner Center (even if you haven't submitted it yet). You can find the button to Create a new add-on on your app's Overview page or on its add-ons page.

After you select Create a new add-on, you'll be prompted to specify a product type and assign a product ID for your add-on.

Here's a list of the info that you provide when creating your add-on submission. The items that you are required to provide are noted below. Some of these are optional, or have default values already provided that you can change as desired.

Create a new add-on page

Field name Notes
Product type Required
Product ID Required

Properties page

Field name Notes
Product lifetime Required if the product type is Durable. Not applicable to other product types.
Quantity Required if the product type is Store-managed consumable. Not applicable to other product types.
Subscription period Required if the product type is Subscription. Not applicable to other product types.
Free trial Required if the product type is Subscription. Not applicable to other product types.
Content type Required
Keywords Optional (up to 10 keywords, 30 character limit each)
Custom developer data Optional (3000 character limit)

Pricing and availability page

Field name Notes
Markets Default: All possible markets
Visibility Default: Available for purchase. May be displayed in your app's listing
Schedule Default: Release as soon as possible
Pricing Required
Sale pricing Optional

Store listings

One Store listing required. We recommend providing Store listings for every language your app supports.

Field name Notes
Title Required (100 character limit)
Description Optional (200 character limit)
Icon Optional (.png, 300x300 pixels)

When you've finished entering this info, click Submit to the Store. In most cases, the certification process takes about an hour. After that, your add-on will be published to the Store and ready for customers to purchase.

Note

The add-on must also be implemented in your app's code. For more info, see In-app purchases and trials.

Set your add-on product type and product ID

An add-on must be associated with an app that you've created in Partner Center (even if you haven't submitted it yet). You can find the button to Create a new add-on on your app's Overview page or on its Add-ons page.

After you select Create a new add-on, you'll be prompted to specify a product type and assign a product ID for your add-on.

Product type

First, you'll need to indicate which type of add-on you are offering. This selection refers to how the customer can use your add-on.

Note

You won't be able to change the product type after you save this page to create the add-on. If you choose the wrong product type, you can always delete your in-progress add-on submission and start over by creating a new add-on.

Durable

Select Durable as your product type if your add-on is typically purchased only once. These add-ons are often used to unlock additional functionality in an app.

The default Product lifetime for a durable add-on is Forever, which means the add-on never expires. You have the option to set the Product lifetime to a different duration in the Properties step of the add-on submission process. If you do so, the add-on will expire after the duration you specify (with options from 1-365 days), in which case a customer could purchase it again after it expires.

Consumable

If the add-on can be purchased, used (consumed), and then purchased again, you'll want to select one of the consumable product types. Consumable add-ons are often used for things like in-game currency (gold, coins, etc.) which can be purchased in set amounts and then used up by the customer. For more info, see Enable consumable add-on purchases.

There are two types of consumable add-ons:

  • Developer-managed consumable: Balance and fulfillment must be managed within your app. Supported on all OS versions.
  • Store-managed consumable: Balance will be tracked by Microsoft across all of the customer’s devices running Windows 10, version 1607 or later; not supported on any earlier OS versions. To use this option, the parent product must be compiled using Windows 10 SDK version 14393 or later. Also note that you can't submit a Store-managed consumable add-on to the Store until the parent product has been published (though you can create the submission in Partner Center and begin working on it at any time). You'll need to enter the quantity for your Store-managed consumable add-on in the Properties step of your submission.

Subscription

If your want to charge customers on a recurring basis for your add-on, choose Subscription.

After a subscription add-on is initially acquired by a customer, they will continue to be charged at recurring intervals in order to keep using the add-on. The customer can cancel the subscription at any time to avoid further charges. You'll need to specify the subscription period, and whether or not to offer a free trial, in the Properties step of your submission.

Subscription add-ons are only supported for customers running Windows 10, version 1607 or later. The parent app must be compiled using Windows 10 SDK version 14393 or later and it must use the in-app purchase API in the Windows.Services.Store namespace instead of the Windows.ApplicationModel.Store namespace. For more info, see Enable subscription add-ons for your app.

You must submit the parent product before you can publish subscription add-ons to the Store (though you can create the submission in Partner Center and begin working on it at any time).

Product ID

Regardless of the product type you choose, you will need to enter a unique product ID for your add-on. This name will be used to identify your add-on in Partner Center, and you can use this identifier to refer to the add-on in your code.

Here are a few things to keep in mind when choosing a product ID:

  • A product ID must be unique within the parent product.
  • You can’t change or delete an add-on's product ID after it's been published.
  • A product ID can't be more than 100 characters in length.
  • A product ID cannot include any of the following characters: < > * % & : \ ? + ,
  • Customers won't see the product ID. (Later, you can enter a title and description to be displayed to customers.)
  • If your previously-published app supports Windows Phone 8.1 or earlier, you must only use alphanumeric characters, periods, and/or underscores in your product ID. If you use any other types of characters, the add-on will not be available for purchase to customers running Windows Phone 8.1 or earlier.

Notifications

Important

To ensure that you receive critical email notifications, you'll be required to verify your email address in Action Center. Go to My Preferences in Action Center to verify.

After publishing an app, the owner of your developer account is always notified of the publishing status and required actions through email and the Action Center in Partner Center.