> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Setting up an app or game at Partner Center, for Managed Partners

> Step-by-step Partner Center setup for Managed Partners to create a product, enable XBOX services, publish, and update the MicrosoftGame.config file.

To add XBOX services functionality to your app or game, start by setting up a product definition in Partner Center, by following the steps below.

**Contents:**

* [1. Create the initial product definition at Partner Center](#ctipdapc)
* [2. Contact your Microsoft Representative to enable your app or game](#cymrtxletaog)
* [3. Publish the game](#ptg)
* [4. Update the MicrosoftGame.config file](#utmgcf)

## Prerequisites

* Have a prototype of your app or game, such as a demo and screen captures.

## Caution

When creating a new App or Game, behind the scenes, Partner Center will register the title’s App Id within the Azure Entra ID tenant that the user is currently signed in with. This App Id is used for MSA authentication when your title is launched by a customer. If the Azure Entra ID tenant or this App Id is ever deleted, MSA authentication for your title will fail and there is no way to recover.

To view the App or Game’s AppID in Azure Entra ID, an Entra ID Tenant Admin can access the [Azure Portal](https://portal.azure.com), ensuring they log in using the same tenant that was active during the app or game creation. In the portal, select the Microsoft Entra ID service, go to **Manage**, and navigate to **App Registrations**. Choose **All applications** and search for the app or game name created in Partner Center.

Ensure the correct Azure Entra ID tenant is being used when creating a new App or Game in Partner Center. If you are unsure or have any concerns please contact your Entra ID Tenant Admin, or Partner Center manager to verify the correct Entra ID is being used while creating a new App or Game.

## 1. Create the initial product definition at Partner Center

1. Go to [Partner Center](https://partner.microsoft.com/dashboard/). The Partner Center dashboard Home page appears.

2. Navigate to **Windows & XBOX** > **Overview**. The "Overview" page appears.

3. Click the **Create a new\...** button, then select a product type, such as app, game, or game demo.

   ![The "Create a new..." menu](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/create-a-new-dot-menu.png?fit=max\&auto=format\&n=gzrdvT5kpqAXKEQt\&q=85\&s=c0f4812a8c48a016accae3a872323e79)

4. The "Create your app by reserving a name" page appears:

   ![The "Create your app by reserving a name" page](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/create-app-reserving-name.png?fit=max\&auto=format\&n=gzrdvT5kpqAXKEQt\&q=85\&s=c3b7562b3d8adff4508a9458891b0190)

   Or, the "Create your game by reserving a name" page appears:

   ![The "Create your game by reserving a name" page](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/create-game-reserving-name.png?fit=max\&auto=format\&n=gzrdvT5kpqAXKEQt\&q=85\&s=216a2dc7559dc41abb0db685ab0949f4)

5. In the **Name** text box, enter the name of your game or app.

   If you want your product to include a reduced, demo version of your game, select the **Create a game demo** check box so that a checkmark appears.

   If you know your Product Group, click the **Product Group** drop-down list and then click your Product Group.

6. Click the **Reserve product name** button. A "Setup" page appears, and initially the top of the page reads "Status: Incomplete":

   **Figure: The "App setup" page:**

   ![The "App setup" page](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/app-setup-page.png?fit=max\&auto=format\&n=gzrdvT5kpqAXKEQt\&q=85\&s=c212a1a007b9a3e2aff878330e9a2e51)

   **Figure: The "Game setup" page:**

   ![The "Game setup" page](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/game-setup-page.png?fit=max\&auto=format\&n=gzrdvT5kpqAXKEQt\&q=85\&s=3178315ce212f6daf352d8de968a3b5e)

7. Select settings for your product. For example, in the **Device family availability** section, you can select the **XBOX > Retail** check box.

8. At the bottom of the "Setup" page, click the **Save draft** button.  The top of the page now reads "Status: Complete", and the **Review and publish** button becomes available.

9. Click the **Review and publish** button.  The "Review and publish" page appears.

   ![The "Review and publish" page](https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/review-and-publish-page.png?fit=max\&auto=format\&n=ktEik-YaZoen6Rhy\&q=85\&s=914bac39271518abf0ff860d4f8a47fe)

10. In the **Publish to** drop-down list, select a sandbox. Sections are added to the page:

    ![The "Review and publish" page with sections](https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/review-and-publish-page-sections.png?fit=max\&auto=format\&n=ktEik-YaZoen6Rhy\&q=85\&s=0bbe641c111eafbfb896a11d37689b7d)

Follow the onscreen Partner Center setup steps for your product.
Once your app or game reaches the Completed state, contact your Microsoft Representative to enable your game, as follows.

## 2. Contact your Microsoft Representative to enable your app or game

1. In Partner Center, select your app or game.

   The "Application overview" or "Game overview" page appears.

2. Click **App setup** or **Game setup**.  The "App setup" page or "Game setup" page appears.

3. Toward the bottom of the page, click the **Identity details** link. The "Identity details" section expands:

   ![The "Identity details" section](https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/identity-details-section.png?fit=max\&auto=format\&n=ktEik-YaZoen6Rhy\&q=85\&s=88423976fc348dda01de625a6c24d791)

4. Copy the **Store ID**.

5. Contact your Microsoft representative to ask them to add XBOX services capability to your title.
   Include the Microsoft Store ID.
   For example:

   * **Subject**: Need to enable game for XBOX services

   * **Body**: "Hi support, please enable XBOX services compatibility for my Partner Center product.  The Microsoft Store ID is \[your game's store ID]."

Your Microsoft representative emails you telling you that your app or game has been enabled in Partner Center.

The initial setup of your app or game is now complete.
Your game cannot be tested yet; you need to publish the game first.
To do this, you take the identity information that was generated above, and push that information into the XBOX services runtime system, as follows.

## 3. Publish the game

In Partner Center, with your game selected as in the above procedures, do the following.

1. In the top right, click the **Publish** link.

   The "Publish gameplay settings" dialog box appears.

   ![The "Publish gameplay settings" dialog box](https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/pc_pubgameplaysetgs_dbx.png?fit=max\&auto=format\&n=ktEik-YaZoen6Rhy\&q=85\&s=8f00b713d5390522798e8efac64424f8)

2. Click the **Confirm** button.

   At the bottom of the dialog box, the message appears: "Publishing configuration..." and then "Publishing configuration finished successfully."

   > [!IMPORTANT]
   >
   > Though the UI says "finished successfully", the XBOX network servers can take as long as 30 minutes to replicate the new info.

3. Click the **Close** button.

   The "Publish gameplay settings" dialog box closes, and the "Gameplay Setting" page remains displayed.

The SDK can now be used in an application to sign-in.

## 4. Update the MicrosoftGame.config file

> [!NOTE]
>
> To ensure successful sign-in, the `MicrosoftGame.config` file needs to match what is in Partner Center exactly. The [MicrosoftGame.config Editor](https://devdocs.xbox.com/build/core-features/common/game-config/MicrosoftGameConfig-Editor.md) provides a Store Association Wizard which will automatically pull down all of the various IDs (MSA App ID, Title ID, Store ID, etc.) from Partner Center on your behalf.
>
> Within the `Identity` element of the `MicrosoftGame.config` file, the value of the `Name` and `Publisher` attributes must match the **Package/Identity/Name** and **Package/Identity/Publisher** values shown in the Game setup page in Partner Center.
>
> Also the values in the `MSAAppID` and `TitleId` elements must also exactly match the **MSA App ID** and **Title ID (hexadecimal)** values shown in Partner Center's XBOX services -> XBOX Settings page. **MSA App Id** can be either a GUID or hexadecimal value.

It is important to correctly set the following fields in `MicrosoftGame.config`:

| Field | Required? | Description | Product type | Notes |
| - | - | - | - | - |
| MSAFullTrust | Optional (PC Desktop only) | Specifies if the Title is declared as "MSA Full Trust". | Game | This should not be used unless otherwise noted by your Account Manager. |
| MSAAppId | Optional | Specifies the Titles MSA App ID, which is used with XBOX services Title ID (as follows) for identity with XBOX services. | Game | The MSAAppId is required if your MicrosoftGame.config specifies a TitleId, NoCodePCRoot or AdvancedUserModel element set to false. |
| TitleId | Optional | Specifies the Titles XBOX services Title ID, used for identity with XBOX services. | Game | The TitleId is required if your MicrosoftGame.config specifies a MSAAppId, NoCodePCRoot or AdvancedUserModel element set to false. |
| RequiresXboxLive | Optional | Specifies if the title requires XBOX services via Gaming Runtime Services (GRTS). | Game | |

```xml theme={null}
<Game configVersion="1">
  <Identity Name="ExactName.InPartnerCenter" Publisher="CN=00000000-0000-0000-0000-000000000000" Version="1.0.0.0" />

  <MSAAppId>000000000000000</MSAAppId>
  <TitleId>00000ABC</TitleId>
  <RequiresXboxLive>true</RequiresXboxLive>
```

For more information on application management, such as the `wdapp register` command, see [Title packaging, content updates, and streaming-installation testing](https://devdocs.xbox.com/build/core-features/common/packaging/title-packaging-streaming-install-testing.md).

For more information on running the game from the start menu and/or debugging, see [MicrosoftGame.config Overview](https://devdocs.xbox.com/build/core-features/common/game-config/MicrosoftGameConfig-Overview.md).


## Related topics

- [Game Saves walkthroughs and samples](https://devdocs.xbox.com/build/core-features/common/game-save/game-saves-walkthroughs-and-samples.md)
- [Get started with Unity for PC development (contents)](https://devdocs.xbox.com/build/gdk-and-engines/unity/unity.md)
- [Setting up web services at Partner Center](https://devdocs.xbox.com/services/xbox-services/fundamentals/s2s-auth-calls/custom-service-config/web-services/live-web-services.md)
- [Portal configuration overview](https://devdocs.xbox.com/services/xbox-services/fundamentals/portal-config/live-portal-config-overview.md)
- [Custom engine integration for PC: get started (C/C++)](https://devdocs.xbox.com/build/gdk-and-engines/custom-engine.md)
