From 5158a1d946c189e42f81561d83016ae57b693202 Mon Sep 17 00:00:00 2001 From: v-spakirla Date: Mon, 27 Jul 2026 12:58:33 +0530 Subject: [PATCH 1/5] Move common validation failure article before Submit in TOC Relocate 'Common reasons for app validation failure' from post-publish section to before 'Submit your app' so developers can review common failures while preparing their submission. Fixes #14114 Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- msteams-platform/TOC.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/msteams-platform/TOC.yml b/msteams-platform/TOC.yml index 49b441a7056..e5e699d9d46 100644 --- a/msteams-platform/TOC.yml +++ b/msteams-platform/TOC.yml @@ -1113,6 +1113,9 @@ - name: Update Apple Developer Program Team ID href: concepts/deploy-and-publish/appsource/prepare/update-apple-store-team-connect-id.md displayName: Enable users to install your app on Teams iOS platform, app acquisition on mobile + - name: Common reasons for app validation failure + href: concepts/deploy-and-publish/appsource/common-reasons-for-app-validation-failure.md + displayName: App description, Partner Center, app manifest, Microsoft trademark and brand guidelines, external domains, testability, bot functionality, AI-generated content, mobile experience, app functionality - name: Submit your app href: /office/dev/store/add-in-submission-guide?toc=/microsoftteams/platform/toc.json&bc=/microsoftteams/platform/breadcrumb/toc.json - name: Resolve issues if your Teams Store submission fails @@ -1124,9 +1127,6 @@ - name: Teams Store ranking parameters href: concepts/deploy-and-publish/appsource/post-publish/teams-store-ranking-parameters.md displayName: Microsoft Publisher Agreement, app update or new release, user engagement data - - name: Common reasons for app validation failure - href: concepts/deploy-and-publish/appsource/common-reasons-for-app-validation-failure.md - displayName: App description, Partner Center, app manifest, Microsoft trademark and brand guidelines, external domains, testability, bot functionality, AI-generated content, mobile experience, app functionality - name: Enable customization for your agent or app href: concepts/design/enable-app-customization.md displayName: Customize your app, update app name, branding, hide and unhide app, accent From 25388dd500ed287febea5d3869226941892e68e0 Mon Sep 17 00:00:00 2001 From: v-spakirla Date: Mon, 27 Jul 2026 13:01:23 +0530 Subject: [PATCH 2/5] Revert "Move common validation failure article before Submit in TOC" This reverts commit 5158a1d946c189e42f81561d83016ae57b693202. --- msteams-platform/TOC.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/msteams-platform/TOC.yml b/msteams-platform/TOC.yml index e5e699d9d46..49b441a7056 100644 --- a/msteams-platform/TOC.yml +++ b/msteams-platform/TOC.yml @@ -1113,9 +1113,6 @@ - name: Update Apple Developer Program Team ID href: concepts/deploy-and-publish/appsource/prepare/update-apple-store-team-connect-id.md displayName: Enable users to install your app on Teams iOS platform, app acquisition on mobile - - name: Common reasons for app validation failure - href: concepts/deploy-and-publish/appsource/common-reasons-for-app-validation-failure.md - displayName: App description, Partner Center, app manifest, Microsoft trademark and brand guidelines, external domains, testability, bot functionality, AI-generated content, mobile experience, app functionality - name: Submit your app href: /office/dev/store/add-in-submission-guide?toc=/microsoftteams/platform/toc.json&bc=/microsoftteams/platform/breadcrumb/toc.json - name: Resolve issues if your Teams Store submission fails @@ -1127,6 +1124,9 @@ - name: Teams Store ranking parameters href: concepts/deploy-and-publish/appsource/post-publish/teams-store-ranking-parameters.md displayName: Microsoft Publisher Agreement, app update or new release, user engagement data + - name: Common reasons for app validation failure + href: concepts/deploy-and-publish/appsource/common-reasons-for-app-validation-failure.md + displayName: App description, Partner Center, app manifest, Microsoft trademark and brand guidelines, external domains, testability, bot functionality, AI-generated content, mobile experience, app functionality - name: Enable customization for your agent or app href: concepts/design/enable-app-customization.md displayName: Customize your app, update app name, branding, hide and unhide app, accent From ff8de772e02189e426259e0b4856f688d79b8dbd Mon Sep 17 00:00:00 2001 From: v-spakirla Date: Mon, 27 Jul 2026 13:02:20 +0530 Subject: [PATCH 3/5] Add cross-links to common validation failure article Instead of moving the TOC entry, add cross-links between related articles so developers discover common validation failures while preparing their submission: - submission-checklist.md: added link to common-reasons article - teams-store-validation-guidelines.md: added link to common-reasons article - common-reasons-for-app-validation-failure.md: added link to submission checklist Fixes #14114 Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .../appsource/common-reasons-for-app-validation-failure.md | 1 + .../appsource/prepare/submission-checklist.md | 3 ++- .../appsource/prepare/teams-store-validation-guidelines.md | 1 + 3 files changed, 4 insertions(+), 1 deletion(-) diff --git a/msteams-platform/concepts/deploy-and-publish/appsource/common-reasons-for-app-validation-failure.md b/msteams-platform/concepts/deploy-and-publish/appsource/common-reasons-for-app-validation-failure.md index 51762e67b41..1018810db67 100644 --- a/msteams-platform/concepts/deploy-and-publish/appsource/common-reasons-for-app-validation-failure.md +++ b/msteams-platform/concepts/deploy-and-publish/appsource/common-reasons-for-app-validation-failure.md @@ -169,6 +169,7 @@ For more information, see [Teams Store validation guidelines for apps with AI-ge ## See also +* [Prepare your Teams Store submission](prepare/submission-checklist.md) * [Publish your Microsoft Teams app](../apps-publish-overview.md) * [Publish your app to the Microsoft Teams Store](publish.md) * [Microsoft Teams Store validation guidelines](prepare/teams-store-validation-guidelines.md) diff --git a/msteams-platform/concepts/deploy-and-publish/appsource/prepare/submission-checklist.md b/msteams-platform/concepts/deploy-and-publish/appsource/prepare/submission-checklist.md index b9b5970a03b..d2409c8c8d0 100644 --- a/msteams-platform/concepts/deploy-and-publish/appsource/prepare/submission-checklist.md +++ b/msteams-platform/concepts/deploy-and-publish/appsource/prepare/submission-checklist.md @@ -276,4 +276,5 @@ Partner Center supports [localized Teams Store listings](/office/dev/store/prepa ## See also -[Prepare your Microsoft 365 tenant](../../../build-and-test/prepare-your-o365-tenant.md) +* [Common reasons for app validation failure](../common-reasons-for-app-validation-failure.md) +* [Prepare your Microsoft 365 tenant](../../../build-and-test/prepare-your-o365-tenant.md) diff --git a/msteams-platform/concepts/deploy-and-publish/appsource/prepare/teams-store-validation-guidelines.md b/msteams-platform/concepts/deploy-and-publish/appsource/prepare/teams-store-validation-guidelines.md index e851ee3faa4..1aedbaeeed9 100644 --- a/msteams-platform/concepts/deploy-and-publish/appsource/prepare/teams-store-validation-guidelines.md +++ b/msteams-platform/concepts/deploy-and-publish/appsource/prepare/teams-store-validation-guidelines.md @@ -1942,6 +1942,7 @@ The long description of an app must clearly call out the following: ## See also +* [Common reasons for app validation failure](../common-reasons-for-app-validation-failure.md) * [Test and debug your app](~/concepts/build-and-test/debug.md) * [Prepare your Teams Store submission](~/concepts/deploy-and-publish/appsource/prepare/submission-checklist.md) * [Include a SaaS offer with your Teams app](include-saas-offer.md) From 93bec971de8dad4e6e256ad5a97beb4564ce779a Mon Sep 17 00:00:00 2001 From: v-spakirla Date: Fri, 31 Jul 2026 12:03:32 +0530 Subject: [PATCH 4/5] Updates --- .../concepts/deploy-and-publish/appsource/publish.md | 1 + .../deploy-and-publish/appsource/resolve-submission-issues.md | 1 + 2 files changed, 2 insertions(+) diff --git a/msteams-platform/concepts/deploy-and-publish/appsource/publish.md b/msteams-platform/concepts/deploy-and-publish/appsource/publish.md index 7788eec7b17..2096bad9fe1 100644 --- a/msteams-platform/concepts/deploy-and-publish/appsource/publish.md +++ b/msteams-platform/concepts/deploy-and-publish/appsource/publish.md @@ -185,3 +185,4 @@ Teams provides intelligent search experience by matching the user input to the f * [Publish tab apps on mobile](../../../tabs/design/tabs-mobile.md#publish-to-teams-store) * [Test preview for monetized apps](prepare/Test-preview-for-monetized-apps.md) * [Microsoft Teams Store ranking parameters](post-publish/teams-store-ranking-parameters.md) +* [Common reasons for app validation failure](../common-reasons-for-app-validation-failure.md) diff --git a/msteams-platform/concepts/deploy-and-publish/appsource/resolve-submission-issues.md b/msteams-platform/concepts/deploy-and-publish/appsource/resolve-submission-issues.md index 06f336b961a..0d3ac4dc5f9 100644 --- a/msteams-platform/concepts/deploy-and-publish/appsource/resolve-submission-issues.md +++ b/msteams-platform/concepts/deploy-and-publish/appsource/resolve-submission-issues.md @@ -84,3 +84,4 @@ If your app isn't published after 1-2 business days, contact