Revise Microsoft 365 developer program setup documentation

[akagarwa-msft]

Updated the Microsoft 365 developer program documentation to reflect the latest information regarding sandbox subscriptions, including changes to the setup process and features available starting July 2026.

[learn-build-service-prod]

Learn Build status updates of commit 0d8f453:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
docs/microsoft-365-developer-program-get-started.md	⚠️Warning	View	Details

docs/microsoft-365-developer-program-get-started.md

• Line 13, Column 258: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#purchase-add-on-services' in 'microsoft-365-developer-program-get-started.md'.
• Line 178, Column 16: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/azure/cost-management-billing/manage/mca-section-invoice' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
• Line 178, Column 16: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/azure/cost-management-billing/manage/mca-section-invoice' will be broken in isolated environments. Replace with a relative link.
• Line 206, Column 155: [Suggestion: other-site-link-broken - See documentation] Link 'https://developer.microsoft.com/microsoft-365/support' points to a page that doesn't exist. Check the path or URL and update the link.

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.

[akagarwa-msft]

@microsoft-github-policy-service agree company="Microsoft"

[learn-build-service-prod]

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

[Copilot]

Pull request overview

Updates the “Set up a Microsoft 365 developer sandbox subscription” documentation to reflect the July 2026 sandbox experience, including instant sandbox defaults, billing-account linking for add-on purchases, and expanded troubleshooting guidance.

Changes:

• Refreshes the instant sandbox description (sample users/data, pre-configured domain, add-on commerce capability).
• Replaces the legacy setup flow with a step-by-step process including billing account selection/creation.
• Adds new troubleshooting sections for billing agreement/account issues and provisioning delays.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[learn-build-service-prod]

Learn Build status updates of commit 62d1353:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
docs/microsoft-365-developer-program-get-started.md	⚠️Warning	View	Details

docs/microsoft-365-developer-program-get-started.md

• Line 178, Column 16: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/azure/cost-management-billing/manage/mca-section-invoice' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
• Line 178, Column 16: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/azure/cost-management-billing/manage/mca-section-invoice' will be broken in isolated environments. Replace with a relative link.
• Line 196, Column 155: [Suggestion: other-site-link-broken - See documentation] Link 'https://developer.microsoft.com/microsoft-365/support' points to a page that doesn't exist. Check the path or URL and update the link.

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-service-prod]

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

[Copilot]

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.

Comments suppressed due to low confidence (5)

docs/microsoft-365-developer-program-get-started.md:13

• The NOTE uses a shortcut reference link ([Purchase add-on services]) but there is no corresponding section/anchor or link definition in this file, so it will render as a broken link. Link directly to the relevant page (or add a matching section/anchor).

> Instant sandboxes issued to eligible customers with enterprise accounts starting July 2026 include add-on commerce capability, so you can purchase additional paid licenses and services including Microsoft 365 Copilot directly from within the sandbox. See [Purchase add-on services] below.

docs/microsoft-365-developer-program-get-started.md:161

• This section says sample data packs "come pre-installed" with the instant sandbox, but earlier the dashboard steps instruct users to install sample data packs (and that the Users pack must be installed first). Please reconcile this so the guidance is consistent (for example, clarify that some data is pre-provisioned and additional packs can be installed).

## Install sample data packs

Sample data packs come pre-installed with your instant sandbox and save you time by automatically providing data and content you need to build and test your solutions. This includes fictitious users, metadata, and photos to simulate a small corporate environment. For details about the sample data packs available, see [Developer sandbox sample data](install-sample-packs.md).

docs/microsoft-365-developer-program-get-started.md:143

• This step says users can use "the existing subdomain that you created", but earlier in this doc the instant sandbox domain is described as pre-configured. Reword to avoid implying the user created the subdomain.

5. **Personalize your sign-in and email**. You can connect your subscription to a domain, or just use the existing subdomain that you created. When ready, choose **Use this domain**, or choose **Do this later**.

6. **Add new users**. You can add fictitious or real users to help you with development. When ready, choose **Add users and assign licenses**.

7. **Assign licenses to unlicensed users**. For any users that you want to be able to work with the subscription, grant them a license. When ready, choose **Add users and assign licenses** or **Do this later**.

docs/microsoft-365-developer-program-get-started.md:59

• Step 1 currently states that Instant sandbox (Add-on purchases enabled) is the default option for everyone, but the NOTE above says add-on commerce is only for eligible enterprise accounts. This can mislead readers who don’t see that option in the UI.

This issue also appears on line 139 of the same file.

1. On your profile page, choose **Set up E5 subscription**.

2. In the setup dialog box, select **Instant sandbox (Add-on purchases enabled)** — this is the default, top option.

3. Choose **Next** to continue to the billing setup screen.

docs/microsoft-365-developer-program-get-started.md:188

• Grammar: "the billing profile with invoice section" is missing an article and reads awkwardly. Rephrase to clearly indicate both items must exist.

Once you have completed the agreement-signing flow and the **billing profile** with invoice section has been created, retry the operation. If you continue to experience issues, please share a screenshot of the billing account page and the error message with the correlation ID so we can investigate further.

[learn-build-service-prod]

Learn Build status updates of commit d1244c6:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
docs/microsoft-365-developer-program-get-started.md	⚠️Warning	View	Details
docs/microsoft-365-developer-program-faq.yml	💡Suggestion	View	Details
docs/images/admin-credentials.png	✅Succeeded	View
docs/images/billing-details-screen.png	✅Succeeded	View
docs/images/create-billing-account.png	✅Succeeded	View
docs/images/dashboard-active-subscription.png	✅Succeeded	View
docs/images/sandbox-type-selection.png	✅Succeeded	View

docs/microsoft-365-developer-program-get-started.md

• Line 188, Column 16: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/azure/cost-management-billing/manage/mca-section-invoice' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
• Line 188, Column 16: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/azure/cost-management-billing/manage/mca-section-invoice' will be broken in isolated environments. Replace with a relative link.
• Line 206, Column 155: [Suggestion: other-site-link-broken - See documentation] Link 'https://developer.microsoft.com/microsoft-365/support' points to a page that doesn't exist. Check the path or URL and update the link.

docs/microsoft-365-developer-program-faq.yml

• Line 26, Column 13: [Suggestion: other-site-link-broken - See documentation] Link 'https://developer.microsoft.com/microsoft-365-copilot' points to a page that doesn't exist. Check the path or URL and update the link.

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-service-prod]

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.