Publishing and testing in the RETAIL sandbox

Important

This article describes features that require enrollment as an XBOX creator. To get started, register for an XBOX developer program. If you're already enrolled but aren't able to use the described features, speak to your XBOX contacts.

Publishing to the RETAIL sandbox is the final step in making your product available to users.

After your game passes certification, ensure that all modules are completed in full and to your expectations. Check your configuration for:

If necessary, ensure you configure Private Audience (see Visibility - Audiences) and XBOX services embargo to restrict visibility of your product and services configuration.

For a detailed checklist of elements to review before you publish, see Game Publishing Readiness Checklist.

Important

Before you can publish to RETAIL, products configured to use the Reseller pricing model must have a revenue SKU. Products without a revenue SKU are blocked from publishing to RETAIL, but can still be published to development sandboxes, or submitted for certification. To request revenue SKU configuration, send the Store ID for your product to your XBOX contacts.

Publishing to Private Audience

Note

Private audience can only be used if a public audience configuration isn't already published to the RETAIL sandbox (for example, for pre-orders or a visible-only Product Details Page).

By default, your product's Microsoft Store Product Details Page (PDP) is visible to a Public audience and is accessible by the public before the first discoverable date via web scraping (or data scraping) technology. If you want to limit your game's PDP to an audience of your choice, enable the Private audience setting. Alternatively, configure Disable Store Presence.

When products are published to the RETAIL sandbox with Private Audience, members of a defined Known User Group can view the PDP and redeem a Promo Code to acquire the product. Users who aren't a member of the specified group can't access the PDP even with a direct link to the page. They also can't acquire the product using a Promo Code.

For more information, see Visibility - Audiences.

Publishing to RETAIL General Availability

Publishing to General Availability (GA) is the process by which content is made widely available in the RETAIL sandbox and to a Public Audience. Before you publish any module to RETAIL, ensure that any changes are final and intended for the configured audience. To publish, use the Review and Publish workflow that's available in your product in Partner Center. Only the Main branch can be published to RETAIL. Any content certified in another branch must be imported to the Main branch before it can be published. If you publish any modules that aren't certified before publishing, the certification workflow for those modules is triggered. Each module must be approved before the publishing workflow continues.

For more information, see Review and publish.

Important

For new products being published, confirm that your Pricing and Availability configuration is set up the way you want it to ensure that your product does not release at the wrong date or time, for the wrong price, or with the wrong visibility. Similarly, ensure that you've selected the correct certified Package and XBOX services source.

For updates to existing products, ensure that you've imported your latest content to the Main branch. For Packages, also confirm that you've configured the appropriate custom availability date or time so that you don't release an update earlier than expected. For more information, see Packages.

Testing in RETAIL with promotional codes

Promo codes (also known as 5×5 codes, tokens, or keys) are ordered via Partner Center for each individual product. For more information about ordering promo codes, see Ordering promotional codes.

Promo codes are used to acquire content in the RETAIL sandbox without making a paid purchase from the Microsoft Store. Use promo codes for RETAIL sandbox testing both pre and post-release. Promo codes can also be used for promotional purposes, for example, to provide reviewers with access to your game. For guidance on specific promo code policies, contact your Microsoft representative, review your license agreement with Microsoft, and review the policies detailed in the XBOX Publisher Guide.

For more information about the RETAIL tests that we recommend completing after using promo codes, see Recommendations for testing in RETAIL.

Note

If private audience is enabled, only members of the user groups configured for the private audience can redeem promo codes.

Test disc validation in RETAIL

If you're releasing a physical version of your game, you must validate and approve your test discs for Release to Manufacture (RTM), after the packages on the disc pass Final Certification. Before test discs can be used with a console connected to the XBOX network, you must publish both your certified package and your XBOX services Gameplay Settings to RETAIL. If these items aren't published, you might see errors when you install or launch the game using the test discs while you're connected to the XBOX network. Before you publish to the RETAIL sandbox, ensure your product configuration is suitable for publishing. You can also test the game offline if you have offline game features.

For more information about validating test discs, see Recommendations for testing in RETAIL.

Next steps

With your product published, you might be ready to review the configuration in the RETAIL sandbox, RTM any discs or support your released game.

  • Last updated on