Create game keys packages

How to get Steam game keys

Steam keys are needed to add a product (game) license to your account. Steam keys are single-use, unique, alphanumeric codes that customers can activate on Steam. Steam keys help you sell your game to a wide range of players, as well as provide your game to beta testers and content-makers for free.

Note
You should have a Steam developer access for game key import from Steam.

To get the game keys:

  1. Go to the Technical Tools section in Steam.
  2. Click Request Steam Product keys.
  3. On the page, select the type of Steam game keys.
Note
In most cases, you need to choose Default Release Keys to upload them to Xsolla.
  1. Wait until you receive your game keys at the email associated with your Steam account.

How to create and set up game keys package

  1. In your project in Publisher Account, go to the Store > Game Keys section.
  2. Click New game key package.
  3. Set the basic package settings:
    1. Add general information for each game, including:
      • Image (optional)
      • SKU
      • Game title
      • Game description (optional)
    2. Add a link to the game page (optional):
      1. Set the Add game page link toggle to On.
      2. If you have not yet created a game page, select Create new game page and specify Game page name.
Note
If you choose Create new game page, a new site will automatically be added to the Site Builder section with the specified name. Later, you can select a template and customize it.
  1. Click Save and Continue.
  2. Select the game distribution platforms and upload a CSV or TXT file with keys. Each key’s alphanumeric combination must be unique. Keys with an identical combination will not be uploaded.
  3. If you want to sell the game before its official release, set the Pre-orders toggle to On. You can specify the release date when the keys will be delivered to users instantly when creating the keys or later.
  4. Click Save and Continue.
  5. Set up pricing for the selected platforms:
    1. Define prices or create free keys:
      • To create a free key package, in the Paid or free field, select Free game key.
      • To set a price, in the Paid or free field, select Paid game key and specify the price in one or multiple currencies.
    2. Set regional prices (optional). To configure regional pricing for specific countries, follow these steps:
      1. In the Country-based pricing in real currency field, click Add price.
      2. Specify country, currency, and price amount.
  6. You can set a limit for purchasing a game key. To do this, switch the Limit the number of times one user can buy game key toggle to On and specify the number of keys a user can purchase.
  7. Click Save and Continue.
  8. After successfully creating a package of keys, a modal window will appear with game keys selling options. These options include selling keys via Site Builder, via widget, or via direct link. You can select one of the options: go to sales setup immediately or return at any time later.

To make changes to the created game keys package, select the key on the Game Keys tab, make changes, and save.

Note

For users to be able to buy the game, the keys need to be uploaded. If the keys run out, additional keys must be uploaded.

You will receive an email notification when there are 25%, 10%, and 0% uploaded keys remaining in each package if you have one of the following roles in Publisher Account:

  • developer
  • owner

Only the project owner can change roles in Publisher Account in the Company settings > Users section.

How to set up display of the game keys package

The game keys package description is displayed in the game catalog if you have set up sales via Site Builder.

The uploaded image for the package is displayed:

  • in the game catalog if you have set up sales via widget or via Site Builder
  • in the order creation window for selling games with any of the methods

When selling games with any method, the image is uploaded through the widget. To upload an image for the keys package:

  1. Proceed to widget customization using one of the ways:
    • Select Create Button Widget in the modal window after creating a key package. You will be redirected to the Widget customization tab for the newly created key package.
    • Select the key package on the Game keys tab and go to the Widget customization tab.
  2. Go to the Background image field and click on the default image name to open the file selection window. Upload the file with the desired image.

How to delete or unload game keys

You can delete or unload game keys in Publisher Account or via API calls.

Examples of using:

  • If you upload game keys for a package other than the one you wanted to sell them in, you must delete all the keys. Once you do that, you’ll be able to upload these keys again to another game key package.
  • If you are using Xsolla Launcher and want to test some game keys without selling them, you can unload the required number of keys for testing. The keys will be available for activation in Xsolla Launcher, but not for sale.

When you delete game keys:

  • System deletes all keys from the Store.
  • After deletion, keys are sent to your email specified in Publisher Account.
  • Keys can be uploaded again to any game key package.

When you unload game keys:

  • You can choose how many keys you want to unload.
  • After unloading, keys are sent to your email specified in Publisher Account.
  • Keys can not be uploaded and be sold to any game key package.
  • Keys can be activated in the entitlement system.
  • Keys are unloaded according to the first-in-first-out principle. Keys uploaded first will be unloaded first too.

Game keys deletion

To delete game keys:

  1. In your project in Publisher Account, go to the Store > Game Keys section.
  2. Choose the game key package.
  3. Go to the Keys and Pre-orders tab.
  4. Select the game distribution platform, click Delete keys and confirm the action.

As a result, all game keys will be removed from the Store and sent to your email.

Also, you can delete game keys via Delete codes API call.

Game keys unload

To unload game keys:

  1. In your project in Publisher Account, go to the Store > Game Keys section.
  2. Choose the game key package.
  3. Go to the Keys and Pre-orders tab.
  4. Select the game distribution platform and click Unload keys.
  5. In the window that opens, set the number of game keys you want to unload and click Unload.

As a result, the unloaded game keys will be sent to your email.

Also, you can unload game keys via Get codes API call.

Was this article helpful?
Thank you!
Is there anything we can improve? Message
We’re sorry to hear that
Please explain why this article wasn’t helpful to you. Message
Thank you for your feedback!
We’ll review your message and use it to help us improve your experience.
Last updated: March 19, 2025

Found a typo or other text error? Select the text and press Ctrl+Enter.

Report a problem
We always review our content. Your feedback helps us improve it.
Provide an email so we can follow up
Thank you for your feedback!
We couldn't send your feedback
Try again later or contact us at doc_feedback@xsolla.com.