-
Notifications
You must be signed in to change notification settings - Fork 1.2k
Update Add-ons documentation (Submit your app) #5465
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Draft
luislera
wants to merge
13
commits into
MicrosoftDocs:docs
Choose a base branch
from
alejogaletto:submit-your-app-addons-changes
base: docs
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Draft
Changes from all commits
Commits
Show all changes
13 commits
Select commit
Hold shift + click to select a range
011956f
Updated and merged store listing pages
luislera 581fef5
Merged app properties pages
luislera d620651
Updated price, availability and schedule price changes documents
luislera a9bd843
Rephrased some content to make it clearer
luislera 708e70a
Updated app submission page
luislera fea637e
Updated toc
luislera 7648bef
Applied minor fixes
luislera 21896be
Fixed some issues
luislera b8d7a2c
Applied PR's feedback
luislera d948534
Applied PR's feedback
luislera 3992774
Update create-app-submission.md
luislera cc98816
Applied PR's feedback
luislera 2386472
Applied PR's feedback
luislera File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
Large diffs are not rendered by default.
Oops, something went wrong.
23 changes: 0 additions & 23 deletions
23
hub/apps/publish/publish-your-app/add-on/add-and-edit-store-listing-info.md
This file was deleted.
Oops, something went wrong.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
72 changes: 72 additions & 0 deletions
72
hub/apps/publish/publish-your-app/add-on/configure-release-schedule.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,72 @@ | ||
--- | ||
description: Learn how to configure precise release scheduling for your app add-on in the Microsoft Store, including setting release and stop acquisition dates for specific markets. | ||
title: Configure precise release scheduling | ||
ms.date: 6/5/2025 | ||
ms.topic: article | ||
ms.localizationpriority: medium | ||
--- | ||
|
||
# Configure precise release scheduling | ||
|
||
The **Schedule** section on the [Pricing and availability](./price-and-availability.md) page lets you set the precise date and time that your app should become available in the Store, giving you greater flexibility and the ability to customize dates for different markets. | ||
|
||
:::image type="content" source="../msix/images/msix-precise-release-scheduling.png" lightbox="../msix/images/msix-precise-release-scheduling.png" alt-text="A screenshot of the Pricing and availability section showing precise release scheduling options."::: | ||
|
||
> [!NOTE] | ||
> Although this topic refers to apps, release scheduling for add-on submissions uses the same process. | ||
> You can additionally opt to set a date when the product should no longer be available in the Store. Note that this means that the product can no longer be found in the Store via searching or browsing, but any customer with a direct link can see the product's Store listing. They can only download it if they already own the product or if they have a [promotional code](../../generate-promotional-codes.md) and are using a Windows 10 or Windows 11 device. | ||
|
||
By default (unless you have selected one of the **Make this app available but not discoverable in the Store** options in the [Visibility](./visibility-options.md#discoverability) section), your app will be available to customers as soon as it passes certification and complete the publishing process. To choose other dates, select **Show options** to expand this section. | ||
|
||
Note that you won't be able to configure dates in the **Schedule** section if you have selected one of the **Make this app available but not discoverable in the Store** options in the [Visibility](./visibility-options.md#discoverability) section, because your app won't be released to customers, so there is no release date to configure. | ||
|
||
> [!IMPORTANT] | ||
> The dates you specify in the Schedule section only apply to customers on Windows 10 and Windows 11. | ||
> | ||
> If your previously-published app supports earlier OS versions, any **Stop acquisition** date you select will not apply to those customers; they will still be able to acquire the app (unless you submit an update with a new selection in the [Visibility](./visibility-options.md#discoverability) section, or if you select **Make app unavailable** from the **App overview** page). | ||
|
||
## Base schedule | ||
|
||
Selections you make for the Base schedule will apply to all markets in which your app is available, unless you later add dates for specific markets (or market groups) by selecting [Customize for specific markets](#customize-the-schedule-for-specific-markets). | ||
|
||
You’ll see two options here: **Release** and **Stop acquisition**. | ||
|
||
## Release | ||
|
||
In the **Release** drop-down, you can set when you want your app to be available in the Store. This means that the app is discoverable in the Store via searching or browsing, and that customers can view its Store listing and acquire the app. | ||
|
||
> [!NOTE] | ||
> After your app has been published and has become available in the Store, you will no longer be able to select a **Release** date (since the app will already have been released). | ||
> Here are the options you can configure for a product’s **Release** schedule: | ||
|
||
- **as soon as possible**: The product will release as soon as it is certified and published. This is the default option. | ||
- **at**: The product will release on the date and time that you select. You additionally have two options: | ||
- **UTC**: The time you select will be Universal Coordinated Time (UTC) time, so that the app releases at the same time everywhere. | ||
- **Local**: The time you select will be the used in each time zone associated with a market. (Note that for markets that include more than one time zone, only one time zone in that market will be used. For the United States, the Eastern time zone is used. A comprehensive list of time zones is shown further down this page.) | ||
|
||
## Stop acquisition | ||
|
||
In the **Stop acquisition** dropdown, you can set a date and time when you want to stop allowing new customers to acquire it from the Store or discover its listing. This can be useful if you want to precisely control when an app will no longer be offered to new customers, such as when you are coordinating availability between more than one of your apps. | ||
|
||
By default, **Stop acquisition** is set to never. To change this, select **at** in the drop-down and specify a date and time, as described above. At the date and time you select, customers will no longer be able to acquire the app. | ||
|
||
It's important to understand that this option has the same impact as selecting **Make this app discoverable but not available** in the [Visibility](./visibility-options.md#discoverability) section and choosing **Stop acquisition: Any customer with a direct link can see the product’s Store listing, but they can only download it if they owned the product before, or have a promotional code and are using a Windows 10 or Windows 11 device.** To completely stop offering an app to new customers, click **Make app unavailable** from the App overview page. For more info, see [Removing an app from the Store](../msix/app-package-management.md#removing-an-app-from-the-store). | ||
|
||
> [!TIP] | ||
> If you select a date to **Stop acquisition**, and later decide you'd like to make the app available again, you can create a new submission and change **Stop acquisition** back to **Never**. The app will become available again after your updated submission is published. | ||
|
||
## Customize the schedule for specific markets | ||
|
||
By default, the options you select above will apply to all markets in which your app is offered. To customize the price for specific markets, click **Customize for specific markets**. The **Market selection** pop-up window will appear, listing all of the markets in which you’ve chosen to make your app available. If you excluded any markets in the [Markets](./market-selection.md) section, those markets will not be shown. | ||
|
||
To add a schedule for one market, select it and click **Create**. You’ll then see the same **Release** and **Stop acquisition** options described above, but the selections you make will only apply to that market. | ||
|
||
To add a schedule that will apply to multiple markets, you’ll create a _market group_. To do so, select the markets you wish to include, then enter a name for the group. (This name is for your reference only and won’t be visible to any customers.) For example, if you want to create a market group for North America, you can select **Canada**, **Mexico**, and **United States**, and name it **North America** or another name that you choose. When you’re finished creating your market group, click **Create**. You’ll then see the same **Release** and **Stop acquisition** options described above, but the selections you make will only apply to that market group. | ||
|
||
To add a custom schedule for an additional market, or an additional market group, just click **Customize for specific markets** again and repeat these steps. To change the markets included in a market group, select its name. To remove the custom schedule for a market group (or individual market), click **Remove**. | ||
|
||
> [!NOTE] | ||
> A market can’t belong to more than one of the market groups you use in the **Schedule** section. | ||
|
||
> [!TIP] | ||
> For more information about **Global Time Zones** you can see the [table](../../best-practices/best-practices.md#global-time-zones) in the best practices section. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I like that we have added this. Why have we excluded the other parameters like what's new, etc.?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The only fields available for updating store listings are the following:

What do you mean with parameters like what's new, etc.?