How to connect store to your site

How it works

To improve game monetization and attract more gamers, you can create a site with a store or connect a store to an already created site. You can sell game keys, virtual items and virtual currencies via a store.

Games demo Items & currencies demo

Connecting and setting up a store described in the instruction is related to the sites created with Site Builder. If you want to connect a store on your own site, use the instruction for creating a store.

You can connect the shopping cart on the landing page via block Store. To activate the shopping cart in Web Shop, set up login through Xsolla Login and set the Shopping cart toggler to On.

Shopping cart connects automatically for other templates when the Store block is added.

The field for promo codes automatically appears in the shopping cart. To set up promo codes, see the instruction.

User flow

  1. The gamer goes to the game’s site and navigates to the store section.

  1. The gamer selects items to buy. The purchase payment process depends on:

Purchase of different items quantity

To buy a single item, the gamer clicks Buy Now and pays for the purchase in the payment UI.

To buy multiple items, the gamer clicks the cart icon and adds the item to a shopping cart. After selecting all the items, the gamer goes to the shopping cart, clicks Go to checkout and pays for the purchase in the payment UI.

Purchase of different item types

To buy game keys, the gamer needs to enter their email in the shopping cart window.

To buy a virtual item or a virtual currency, the gamer needs to log in to the site. After the user is logged in, the system can start the payment process or charge virtual currency to the user balance and subtract from it depending on the type of currency for which the item is sold.

Virtual items that are priced in virtual currency cannot be added to the shopping cart. After clicking the Buy Now button, money is subtracted from the user balance automatically.

How to get it


  1. Sign up and create your Xsolla Publisher Account.
  2. Go to Xsolla Site Builder and create a site with one of the templates.

Integration flow

To connect the store to your site:

  1. Set up store modules in Publisher Account.
  2. Add a store section to the site.
  3. Set up the item type in the Store block.

Store modules setting

To set up store modules in Publisher Account:

  1. Open your project and click Connect in the Store block.

  1. Click Connect next to the section with the item type you want to sell on the site:

Adding store section to site

If you created the site with the Store template, the store section is added to the site automatically.

To add the store section to your site:

  1. Go to Site Builder and click Open Site Builder next to your site section.

  1. Click + Add block in the site template.

  1. Select Store in the blocks list.

Item types setting

To set up the item type:

  1. Go to Site Builder and click Open Site Builder next to your site section.

  1. Open the Store block in the settings menu.

  1. Select the item type you want to sell on the site and their group in the drop-down list.

If the items list is empty or you want to create a new item, click the create button or the Set up purchases link at the bottom of the section.

To sell different item types in the different areas of the site, create multiple store sections. Click Add store section in the Store block menu.

  1. Customize the section heading (optional). To do this, click the Store heading in the site template and edit its text and style.


Watch the tutorial videos for this instruction:

  • How to set up an online store for your virtual items

  • How to launch direct game sales with Xsolla

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.
Rate this page
Rate this page
Is there anything we can improve?

Don’t want to answer

Thank you for your feedback!

Useful links

Last updated: December 30, 2022

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!