Add clear explanation of trial expiration behavior in pricing documentation#5672
Add clear explanation of trial expiration behavior in pricing documentation#5672Copilot wants to merge 2 commits into
Conversation
|
Learn Build status updates of commit c54cd7e:
|
Co-authored-by: GrantMeStrength <1928855+GrantMeStrength@users.noreply.github.com>
|
Learn Build status updates of commit d4230e2:
|
| File | Status | Preview URL | Details |
|---|---|---|---|
| hub/apps/publish/publish-your-app/pwa/price-and-availability.md | Details | ||
| hub/apps/publish/publish-your-app/msix/price-and-availability.md | ✅Succeeded |
hub/apps/publish/publish-your-app/pwa/price-and-availability.md
- Line 9, Column 1: [Warning: duplicate-h1s - See documentation]
H1 'Set pricing and availability' is duplicated with other articles: 'apps/publish/publish-your-app/add-on/price-and-availability.md(9,1), apps/publish/publish-your-app/pwa/price-and-availability.md(9,1)'. First level headings must be unique within a docset.
For more details, please refer to the build report.
Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.
|
Learn Build status updates of commit d4230e2:
|
| File | Status | Preview URL | Details |
|---|---|---|---|
| hub/apps/publish/publish-your-app/pwa/price-and-availability.md | Details | ||
| hub/apps/publish/publish-your-app/msix/price-and-availability.md | ✅Succeeded |
hub/apps/publish/publish-your-app/pwa/price-and-availability.md
- Line 9, Column 1: [Warning: duplicate-h1s - See documentation]
H1 'Set pricing and availability' is duplicated with other articles: 'apps/publish/publish-your-app/add-on/price-and-availability.md(9,1), apps/publish/publish-your-app/pwa/price-and-availability.md(9,1)'. First level headings must be unique within a docset.
For more details, please refer to the build report.
Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.
…toc_for_store_update Update title and TOC
|
Is this correction still relevant, @IpsitaChoudhary ? |
There was a problem hiding this comment.
Pull request overview
Improves the pricing/availability documentation by clarifying what users should expect from Store-managed free trials (time-limited vs unlimited), and by pointing developers to implementation docs when they want custom trial behavior.
Changes:
- Added explicit “what happens when the trial expires” guidance for time-limited trials.
- Added explicit “what happens with unlimited trials” guidance (including behavior when no limiting code is implemented).
- Added an “Implementation guidance” subsection linking to the trial-implementation article.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.
| File | Description |
|---|---|
| hub/apps/publish/publish-your-app/msix/price-and-availability.md | Adds trial-expiration/default-behavior explanation and an implementation link for MSIX pricing docs. |
| hub/apps/publish/publish-your-app/pwa/price-and-availability.md | Adds the same trial-expiration/default-behavior explanation and implementation link for PWA pricing docs. |
| **What happens when the trial expires:** | ||
| - **If you don't implement trial-limiting code in your app:** The app will continue to function normally, but the Store licensing system will prevent the app from launching once the trial period expires. Users will see a dialog prompting them to purchase the app. | ||
| - **If you implement trial-limiting code:** Your app can detect the license state and take custom actions such as displaying purchase prompts, disabling features, or closing the app gracefully. |
| **What happens when the trial expires:** | ||
| - **If you don't implement trial-limiting code in your app:** The app will continue to function normally, but the Store licensing system will prevent the app from launching once the trial period expires. Users will see a dialog prompting them to purchase the app. | ||
| - **If you implement trial-limiting code:** Your app can detect the license state and take custom actions such as displaying purchase prompts, disabling features, or closing the app gracefully. |
Issue
Users configuring free trials in Partner Center were unclear about what happens when trial periods expire. The documentation didn't explain whether app startup restrictions are handled automatically by the Store system or require custom implementation by developers.
Changes
This PR adds comprehensive explanations to the Free Trial sections in both MSIX and PWA pricing and availability documentation:
Time-limited Trials
Unlimited Trials
Implementation Guidance
Added a new section linking to the detailed developer documentation (
/windows/uwp/monetize/implement-a-trial-version-of-your-app) for those who want to implement custom trial behavior.Impact
This directly addresses the confusion expressed in the original issue and provides developers with clear expectations about default trial behavior while pointing them to implementation resources when custom behavior is desired.
Files changed:
hub/apps/publish/publish-your-app/msix/price-and-availability.mdhub/apps/publish/publish-your-app/pwa/price-and-availability.mdFixes https://github.com/MicrosoftDocs/windows-dev-docs/issues/[issue-number]
Original prompt
💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.