Skip to content

How to Setup Xbox

Jump to bottom
James edited this page Aug 15, 2026 · 1 revision

Upload a game package to Microsoft Partner Center via the Store Submission API.

!NOTE: The Xbox service is marked Experimental. It works, but expect rough edges.

!IMPORTANT: This page only covers the Build Uploader side. Getting a Partner Center account, being approved as a developer, and registering your game are all handled by Microsoft and are outside what this tool does. If you don't already have a Partner Center app with an Azure AD registration, start with your Microsoft account manager or the Partner Center dashboard.

What you need before you start

Four values, all from Microsoft:

Value Where it comes from
Product ID Partner Center -> App Management -> App identity
Tenant ID The Azure AD directory your Partner Center account is tied to
Client ID The Azure AD app registration used for API access
Client Secret Generated alongside the Client ID in Azure AD

The Azure AD app registration must be associated with your Partner Center account and granted access to the Store Submission API. That association is done in Partner Center under Account settings->User management->Azure AD applications.

Where things get saved

  • Edit->Preferences->Build Uploader->Services->Xbox holds the Client Secret only. Saved to your own PC and never written into your project.
  • Project Settings->Build Uploader->Services->Xbox holds the Product ID, Tenant ID and Client ID. All three are safe to commit.

1. Setup Project Settings: Project Settings->Build Uploader->Services->Xbox

Do this one first - the Preferences page has nothing to show until an app exists.

  • Press Add App
    • Name: anything you like. This is just a label so you can pick it in a dropdown later. eg: My Game
    • Product ID: from Partner Center
    • Tenant ID: from Azure AD
    • Client ID: from Azure AD

The two console buttons at the top of the page open Partner Center and the Azure Portal.

2. Setup Preferences: Edit->Preferences->Build Uploader->Services->Xbox

  • Turn on Enabled
  • Find the app you created in step 1
    • Client Secret: the secret from your Azure AD app registration

!NOTE: If this page says "No apps configured yet", go back and do step 1.

3. Use it in an Upload Config

  • Go to Window->Build Uploader->Open Window
  • Add an Xbox destination to your Upload Config
    • App: the app you made
    • Wait for Cert: turn on to wait for a submission status after committing, so you know the package was accepted. Adds time to the upload
    • Remove Failed Pending Submission: turn on to delete an existing pending submission before starting a new one
      • Useful when a previous submission failed and is now blocking new ones
    • Submission ID Key: optional. Names a {key} holding the submission ID so a later action can reference it

Clone this wiki locally