Set up user authentication

Authentication allows users to buy items in the Web Shop and see unique offers in the catalog.

Key features of the Web Shop with authentication:

  • Multiple authorization methods in the Web Shop.
  • Set up personalized storefronts and promo codes for authorized users.
  • Compliance with regional laws and regulations for the protection and processing of personal data.
  • Rate limit and DDoS protection.

You can choose one of the following authentication methods:

  • User ID authentication:
    • Simplifies the integration of the Web Shop with the game.
    • The authentication widget does not require registration or password entry. A user simply needs to enter the user ID from the game or use the same social network account for login as for logging in to the game.

Use user ID authentication if Xsolla Login isn’t set up in your game.
  • Authentication via Xsolla Login:
    • Provides a wide range of authorization methods: social networks, one-time codes or links, and login and password.
    • Allows you to customize the Xsolla Login widget.
    • You can impose age restrictions on authorization.
Use Xsolla login authentication if this solution is already set up in your game.
For any of the authentication method, you can add a Fast Login block to your site.

Set up Fast Login block

The Fast Login block provides users with an additional way to authenticate on the site.

The appearance of the block and its features depend on the selected authentication method.

If authentication via user ID is configured for the site, the Fast Login block displays a field for entering the ID and a login button.


  • User authentication without additional transition to the modal window.
  • Setting up the content of the block. You can enable and configure the following sections:
    • Title
    • Description
    • Instructions on how to find the user ID
    • Custom background

You can also expand the features of the block, for example, add text, a button, or an image, using JS code.

If authentication via Xsolla Login is configured for the site, an additional button calling for authorization is displayed in the Fast Login block. When you click on the button in the block, a modal window opens for authorization using one of the Xsolla Login methods.


  • Setting up the text of the button calling for authorization
  • Setting up a custom background

You can also expand the features of the block, for example, add text, a button, or an image, using JS code.

For new sites, the Fast Login block is added to the Web Shop template by default, and you can remove it if necessary.

If you created a site earlier and it doesn’t have a Fast Login block, you can add it.

To add a Fast Login block:

  1. Open the project in Publisher Account.
  2. In the side menu, click Site Builder.
  3. In the Sites section, select your site and click Open Site Builder.
  4. Click Add block.
  5. Choose Fast Login block.

To use the Fast Login block, an authorization option should be chosen in advance from the drop-down list in the Login settings section.

For the user ID authentication method in the Login settings section, you also need to specify the URL to receive the webhook. If you don’t specify it, the site can’t be published because user authentication will be unavailable.

User authentication during site preview is possible without adding a webhook URL.

Next steps

  1. Test Web Shop in sandbox mode.
  2. Publish the site.

Integration flow

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!
Last updated: March 4, 2024

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!