Skip to main content
A playtest runs in the RETAIL sandbox, the live environment players use. When the build uses XBOX sign-in, achievements, presence, or other XBOX services, the game needs Full XBOX services, and its XBOX services configuration must be published to RETAIL. Testers then use the same live XBOX services as players of a released game. See XBOX services and Playtest. Do these steps once, before you create the playtest:
  1. Get Full XBOX services.
  2. Choose what happens to achievements.
  3. Set the embargo.
  4. Publish the configuration to RETAIL.
The examples use the XBOX title ID 1234ABCD and a development sandbox, XDKS.1, that holds the configuration the build was tested with.

1. Get Full XBOX services

A new game starts with XBOX services disabled. Limited XBOX services work only in development sandboxes, and don’t include achievements or stats. After your game concept is approved, send the game’s Store ID to your XBOX representative and ask them to onboard the product. Then select Enable full XBOX services on the game’s Game setup page in Partner Center. See Enable XBOX services. Until then, configuration with achievements fails validation:

2. Choose what happens to achievements

Achievements published to RETAIL are permanent. You can still change their names, descriptions, and art, but you can’t remove them or change their unlock rules or gamerscore. Stats published to RETAIL can’t be deleted either. The game’s achievement system, title-managed or event-based, is fixed by the first RETAIL publish. Before that publish, choose one of these: A game for PC or XBOX consoles can’t skip publishing its achievements to RETAIL. In Partner Center, answering No to Publish Achievements to Retail? fails with:
All published achievements must meet the XBOX Requirements for achievements and gamerscore. See Achievements.

3. Set the embargo

The embargo hides the game’s achievements, presence, and other XBOX services data from players in the XBOX app and console UI until a date you choose, and blocks screenshots and video capture. Without one, players outside the playtest can see the game’s configuration. Set an embargo only for a game that isn’t released yet. On a released game, a new embargo hides its XBOX services data from its players. In Partner Center, open XBOX services > XBOX settings, go to Embargo date, and set a UTC date and time later than the playtest’s end, and no later than the game’s public release. If the playtest runs past the release, end the embargo at the release. Select Allow Multiplayer Invites in Embargo if testers invite each other to multiplayer sessions. See Configure embargo date. The embargo is a title-wide setting, stored in the ALL sandbox, and applies to every sandbox. To check it, download ALL:
productdeveloper.xml holds the embargo:
The embargo goes live when the title-wide configuration is published. If Partner Center shows unpublished changes, publish them there, or with --sandbox-id HIDDEN:
A title-wide publish publishes every pending title-wide change, not only the embargo, and those changes reach RETAIL too. Review the pending changes first.
The command asks before it publishes. See Source selection. Publishing is asynchronous. Before you publish to RETAIL, check that lastPublish shows the title-wide publish succeeded:

4. Publish the configuration to RETAIL

Publish the development sandbox’s configuration straight to RETAIL. RETAIL doesn’t require a publish to CERT first, or certification.
A RETAIL publish is live for players as soon as it finishes, and published achievements can’t be removed. See Safety and destructive operations.
Validate first. Validation changes nothing, and lists the achievements the publish adds:
If validation shows the FirstRetailPublishWithoutEffectiveEmbargo warning, no embargo is in effect yet. Finish step 3, including the title-wide publish. Publishing from XDKS.1 replaces RETAIL’s working documents that have the same names, and RETAIL’s global title storage files, deleting any files only RETAIL holds. See Cross-sandbox publishing. When the validation is clean, publish. The command describes the publish and asks first:
Check lastPublish until the publish finishes:
Then create and publish the playtest.
Last modified on November 18, 2026