Skip to content

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented Aug 26, 2025

The allowSubdomains field in the web-to-app linking JSON configuration was missing from the documentation, despite being essential for subdomain support. Users registering both main domains (e.g., example.com) and wildcard subdomains (e.g., *.example.com) in their app manifest need this field to enable proper subdomain handling.

Problem:
Without allowSubdomains: true in the JSON file, subdomain links like fr.example.com/path would open in the browser instead of the app, even when the app manifest includes wildcard subdomain registration.

Changes:

  • Added a new "Subdomain support" section explaining when and why the field is needed
  • Included a complete JSON example demonstrating the allowSubdomains field usage
  • Added a note in the "Multiple apps" section about including the field for each app entry
  • Clarified that without this field, subdomain links will open in browser instead of the app

The documentation now provides complete guidance for developers who need subdomain support in their web-to-app linking configuration.

Fixes #4510.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • maps.windows.com
    • Triggering command: curl -s REDACTED (dns block)

If you need me to access, download, or install something from one of these locations, you can either:


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Copy link
Contributor

Learn Build status updates of commit d794142:

⚠️ Validation status: warnings

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.

@alvinashcraft alvinashcraft self-requested a review August 26, 2025 16:58
Co-authored-by: alvinashcraft <73072+alvinashcraft@users.noreply.github.com>
@Copilot Copilot AI changed the title [WIP] allowSubdomains field in server-side json Document allowSubdomains field for web-to-app linking JSON configuration Aug 26, 2025
Copy link
Contributor

Learn Build status updates of commit 4d98764:

✅ Validation status: passed

File Status Preview URL Details
hub/apps/develop/launch/web-to-app-linking.md ✅Succeeded

For more details, please refer to the build report.

@alvinashcraft alvinashcraft marked this pull request as ready for review August 26, 2025 17:05
@alvinashcraft alvinashcraft merged commit 42cded2 into docs Aug 26, 2025
2 checks passed
@alvinashcraft alvinashcraft deleted the copilot/fix-4510 branch August 26, 2025 17:08
Copilot finished work on behalf of alvinashcraft September 28, 2025 00:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

allowSubdomains field in server-side json
2 participants