XR-074: Loss of Connectivity to XBOX and Partner Services *

Version 2.0, 11/1/2025

Titles must gracefully handle errors with XBOX and partner services connectivity. Titles must honor the retry policies set by XBOX when attempting to retry a request to the XBOX service after a failure has occurred. Titles must appropriately manage messaging the user when services are unavailable. If a partner service is not available, the game must not indicate that there is an issue with the XBOX network. Titles must not crash or hang if network services are slowed or intermittently available.

More Information

Titles should react to the performance of their own network operations and/or use Windows.Xbox.Networking network quality APIs to determine current network conditions. They should also degrade gracefully by transferring less data, choosing appropriate user roles, or leveraging cloud services.

Handling Issues With Non XBOX Services

Titles encountering issues with partner services such as non-transient timeouts, network API errors, or missing service configuration that impacts the user experience should alert the user to the specific feature or service that is unavailable. Titles should fail gracefully to a safe state while the user troubleshoots, or to a state in which the user can manually retry.

An example of a user-friendly message is:

"Sorry, non-Microsoft service is not currently available. Please try again later. For more information, contact non-Microsoft support contact information."

Handling Issues With XBOX Services

Some functionality might become unavailable if connectivity to an XBOX service is lost. In such instances, titles should use clear, user-friendly messaging to communicate this to users.

If a service is unavailable, titles are permitted to retry their request, but they can do so only within the parameters allowed by XBOX. For more information about service resiliency for XBOX console titles, including required HTTP retry and back-off logic, as well as user-interaction guidance for individual services, see Service Interruption Resiliency for Titles

Requiring XBOX Connectivity

When developing for XBOX consoles, titles that require connectivity to the Internet—or XBOX, in particular—for the majority of their functionality might want to include the Boolean flag RequireXboxLive in their AppX manifest. This will block the title from initiating on the XBOX console when XBOX is unavailable and it will suspend, and subsequently terminate, the title if connectivity is lost.

For information on networking using the GDK, read the Networking section.

Certification Test Cases

074-01 WAN Disconnection to XBOX Services

Test Steps

  1. Sign in to an XBOX profile.
  2. While performing the following actions, disconnect the WAN network. If you are using an Ethernet switch/hub disconnect the uplink cable from the network device. If the device is connected via Wifi, disconnect the uplink cable from the wireless access point connection:
    • Creating a new save point
    • Loading a save point
    • Reaching an auto-save point
    • Enumerating a list of saved games
    • Searching for and joining an online session
    • Attempting to create an online session
    • Viewing a leaderboard (if applicable)
    • Playing offline

Expected Result
In the event that the console is unable to reach XBOX services, the title should respond with a user-friendly error message.

Pass Examples

  1. The title displays an error message indicating loss of network connection to XBOX services.
  2. The title does not display an error message while playing a local game mode that does not require XBOX services.
  3. A title with RequireXboxLive in AppX manifest suspends and then terminates when connectivity is lost.

Fail Examples

  1. The user is unable to complete a non-online XBOX game session.
  2. Title goes into an unresponsive or unstable state.

074-02 Direct Disconnection

Test Steps

  1. Launch the title and sign in to an XBOX profile.
  2. While performing the following actions in the title, pull the network cable from the device, or power off the WAP or wireless router:
    • Creating a new save point.
    • Loading a save point.
    • Reaching an auto-save point.
    • Enumerating a list of saved games.
    • Searching for and joining an online session.
    • Attempting to create an online session.
    • Viewing a leaderboard (if applicable).
    • Playing offline.

Expected Result
In the event the device loses connection to XBOX services, the title should respond with a user-friendly error message.

Pass Examples

  1. The title displays a user-friendly message while in online game mode.
  2. The title does not interrupt gameplay during offline game mode.
  3. A title with RequireXboxLive in AppX manifest suspends and then terminates when connectivity is lost.

Fail Examples

  1. An error message is displayed during offline game mode.
  2. The title goes into an unresponsive or unstable state.
  3. The user is able to view online menus or view buffered media after the network goes offline.

074-03 Suspend Disconnection to XBOX Services

On retail consoles, a game will be suspended under the following conditions:

  • When the console enters Connected Standby by being turned off with the power mode set to Instant-on.
  • When the game remains out of focus for ten minutes. For example, launching an application such as Settings and keeping it in focus for ten minutes.

For the purposes of this test case, both methods at step 3 should be verified.

Test Steps

  1. Sign into an XBOX profile with the console power mode set to Instant-on.
  2. Launch the game and progress into gameplay.
  3. At various points throughout game, suspend the game.
  4. Resume the game and verify the game handles the disconnection gracefully.
  5. Repeat Steps 3-4 throughout the game.

Expected Result
In the event that the console is unable to reach XBOX services after being suspended, the title must resume successfully, handle the situation gracefully, and respond with a user-friendly error message where appropriate.

Pass Examples

  1. During an online XBOX multiplayer session, the title displays an error message indicating loss of network connection to XBOX services.
  2. The title does not display an error message while playing a local game mode that does not require XBOX services.

Fail Examples

  1. The user is unable to complete a non-online XBOX game session.
  2. The title goes into an unresponsive or unstable state.
  3. The title displays a misleading or incorrect error message after resuming.

074-04 XBOX Service Re-connection During Suspend

On retail consoles, a game will be suspended under the following conditions:

  • When the console enters Connected Standby by being turned off with the power mode set to Instant-on.
  • When the game remains out of focus for ten minutes. For example, launching an application such as Settings and keeping it in focus for ten minutes.

For the purposes of this test case, both methods at step 3 should be verified.

Test Steps

  1. Sign into an XBOX profile with the console power mode set to Instant-on and ensure the console is set to Home.
  2. With no connection to XBOX but retaining a local network connection, launch the title.
    • If utilizing a ethernet switch/hub disconnect the uplink cable from the network device.
    • If the device is connected via Wifi, disconnect the uplink cable from the wireless access point.
  3. At various points throughout the game, suspend the game.
  4. Reconnect the uplink cable and wait for the console to reconnect to XBOX services.
  5. Resume the game and verify the game handles the re-connection gracefully.
  6. Repeat Steps 2-5 throughout the game.

Expected Result
In the event that the console is unable to reach XBOX services after being suspended, the title must resume successfully, handle the situation gracefully, and respond with a user-friendly error message where appropriate.

Pass Examples

  1. The user is able to resume the title and complete an offline XBOX game session without interruption.
  2. The title remains stable and does not crash.

Fail Examples

  1. The user is unable to complete a non-online XBOX game session.
  2. The title goes into an unresponsive or unstable state.
  3. The title displays a misleading or incorrect error message after resuming.

074-07 Dynamic Connectivity Loss

Tools Needed:

Configure XMAT to block partner services

For installation, capture setup, and scripting instructions, see Use XBOX Multiplayer Analysis Tool to inspect and modify network traffic.

  1. Start XMAT as an administrator and add a Web Proxy capture for the device under test.
    • On an XBOX development console, select Enable XBOX Proxy and wait for the console to restart.
    • On Windows, select Start Capture.
  2. With XMAT capturing, launch the title and navigate all menus, complete a multiplayer session, load every game mode, and navigate all areas of the title, including:
    • Menus.
    • Leaderboards.
    • Servers (create one and join someone else's).
    • Friends lists.
    • In-title stores.
    • Limited-time events.
  3. Use the Host filter to identify the partner service hosts contacted during normal gameplay. Confirm that the selected hosts don't belong to Microsoft, XBOX, or PlayFab before blocking them.
  4. Open the Script Editor, select the SSL Connection Request event, and create a script that sets Params.Continue to false for each partner service host.
  5. Enable the script and verify that it compiles successfully. Then disable the script so that partner services remain available when the test begins. Keep the XMAT capture running.

Test Steps

  1. With the XMAT blocking script disabled, sign in to an XBOX profile and launch the title.
  2. Navigate to a title feature that uses a partner-hosted service and confirm that the feature is available.
  3. Without closing the title, enable the XMAT blocking script.
  4. Continue through the title and exercise all applicable areas, including:
    • Menus
    • Leaderboards
    • Servers (create one and join someone else's)
    • Friends List
    • In-title Store
    • Limited time events
  5. Verify the title does not display an error message indicating an issue with the XBOX network.

Expected Result
The title gracefully handles disconnections to non-Microsoft services.

Pass Examples

  1. Title does not hang or crash upon loss of connectivity to partner-hosted services.

Fail Examples

  1. Message displayed implies issues with Microsoft services.
  2. Non-descriptive error message is displayed.
  3. Title crashes, becomes unstable, or causes console reboot.

074-08 Pre-Launch Downtime

Tools Needed:

Test Steps

  1. On consoles, create a broken network channel with xbstress.exe for non-Microsoft traffic using the command:

xbstress set channel=0 network=broken addresses=[semicolon delimited list of addresses]

  1. Start the network simulation with the command: xbstress simulate network=channels.
  2. If testing on Windows, configure an XMAT web proxy capture and enable a script that blocks the applicable partner service hosts before launching the title.
  3. Sign in to an XBOX profile.
  4. Launch the title.
  5. Access non-Microsoft online feature.

Expected Result
Titles should provide a user-friendly error message indicating that there is a problem reaching the non-Microsoft service and should allow an opportunity to retry connection.

Pass Examples

  1. Title does not hang or crash upon loss of connectivity to the partner-hosted service.

Fail Examples

  1. Error displayed implies issues with Microsoft service.
  2. Non-descriptive error message is displayed.
  3. Title crashes, becomes unstable, or causes console reboot.
  • Last updated on