Documentation

In-App Purchasing

Client API

SDK API

In-App Purchasing

Create a webshop

Reserve a studio name and slug, then create a webshop connected to your Unity Cloud project's IAP catalog and payment provider.
Read time 4 minutesLast updated 13 hours ago

Create a webshop in the Unity Dashboard and connect it to a Unity Cloud project. During webshop creation, Unity connects the webshop to the project's IAP catalog and payment provider if they already exist. You can also connect them later. When you create the webshop, it appears in the Webshop list with the status In draft. You can then theme and publish it. The first webshop in your organization also sets the organization-wide studio name, which appears in every shop URL. For how the studio name is used, refer to Introduction to webshops.

Prerequisites

Before you create a webshop, you need a Unity Cloud project. You can create and publish a webshop without an IAP catalog or payment provider. However, players can't browse or buy products until you connect both. To test the full purchase flow, connect an IAP catalog and payment provider before you start. Otherwise, you can connect them later in the Edit view. To create an IAP catalog, complete Create a catalog in the Editor. To preview themes before you connect a real catalog, go to the Edit view and enable Mock catalog. Mock products appear only in the Dashboard preview. To connect a payment provider, refer to Payment providers.

Create a webshop

To generate a webshop from the Unity Dashboard, follow these steps:
  1. Open your Unity project.
  2. Select Monetization > Webshop > Create webshop.
    Note
    If you use the legacy Unity Dashboard, go to In-App Purchases > Go to Webshop.
  3. Select your project from the dropdown list. The project's IAP catalog and payment provider are connected automatically.
  4. If this is your first webshop, then enter a globally unique studio name.
    Note
    If your organization already has a webshop, the field shows the existing studio name as read-only.
  5. Select Create.
The new webshop appears in the list with status In draft. The default slug is generated from the project's name. You can change it from the Edit view's Shop URL field if needed.

General settings

After you create a webshop, open it from the Webshop list and complete the following fields.

General setting

Description

Webshop nameSpecifies the webshop name. This appears at the top of the live shop and in the storefront header for players. It also identifies the webshop in the Dashboard.
Studio nameThe studio name is prefilled from the previous step at webshop creation. The studio name appears in every shop URL in your organization. To rename it, select the arrow and make the edit by selecting the pencil icon next to the studio name.
Webshop statusIndicates whether the webshop has unpublished or published changes:
  • In draft: indicates there are unapplied changes.
  • Live: indicates that changes are published.
Shop URLRefers to the last part of the shop URL, also called the slug. For example, in
shop.unity.com/acme/game/dungeons
, the slug is
dungeons
. You can edit the slug. When you publish a change, the previous URL is deprecated. Shop URLs must be unique. If your studio name or game name is already in use by another Unity organization and you believe it infringes your copyright, contact Unity support. For slug format and rename behavior, refer to Introduction to webshops.
Activated environmentShows the Unity Environment where the webshop was first published. You can publish and unpublish the webshop only from this environment. Use the environment switcher (next to Edit webshop) to manage webshops in other environments. You can create one webshop per environment for testing. Non-production environments support testing through the preview URL only. Refer to Unity Environments to learn more.
Dev preview URLA pre-authenticated preview link that displays the selected environment's current draft in a browser. Useful for previewing changes without integrating the shop into your game.

Catalog and payment provider settings

The Catalog & payment provider section displays the catalog and payment settings inherited from the Unity Cloud project:

Field

Description

CatalogDisplays the IAP catalog's connection status. Select Manage catalog to open the catalog editor. Refer to Define your products.
Mock catalogDisplays sample products in the preview so you can review the webshop layout before you connect a real catalog. This affects only the Preview pane and doesn't affect the live webshop. Mock products never appear in the public shop.
Payment providerDisplays the payment provider connection status. Select Manage payment to configure payment provider information. Refer to Payment providers to learn more.
Fallback providerDisplays the payment provider used when no tag-based routing rule matches a player. Use the dropdown to set the fallback provider. Changes are applied at runtime and don't require you to republish the webshop.
Deeplink URLThe deep link to your game, for example
mygame://purchase-success
. The webshop uses it both to return players after a purchase and to authenticate players with your game when an unauthenticated player visits the site (for example, if they clicked your shop link in an email or a Discord message). Leave the field empty to disable both of these functionalities.

The webshop uses the link, exactly as you enter it, to return players to your game. You can add a custom post-purchase path. When using your link to authenticate players, the webshop automatically modifies it and handles this case with the Unity IAP SDK. For format and limits, refer to Webshop limits reference. For the game-side flow, refer to Open a webshop from your game.
For the broader catalog and payment model, refer to Catalog and payments in webshops.

Player authentication settings

The Player authentication section controls the sign-in methods available in the webshop. When you create a webshop, Unity activates Unity Player Accounts for the project automatically if Player Accounts aren’t already active. You don’t need to set up Player Accounts separately before players can sign in.

Field

Description

Sign-in providersThe Unity Player Accounts sign-in providers that the webshop offers: Google, Apple, and Email. A new webshop offers all three providers by default. Add or remove providers from the field, or remove all providers to disable sign-in. For more information, refer to Player sign-in for webshops.

Next steps

Follow these steps to customize and publish your webshop: