Photon Cloud provides you with global connectivity to allow low latency gaming all around the world.

The initial connection of clients goes to a Photon Name Server, which provides the list of available regions.

Each region is completely separate from the others and consists of a Master Server (for matchmaking) and Game Servers (hosting rooms).

Photon Cloud Regions' Connect Flows
Connect to Photon Cloud regions

The full list of available regions is below. In the Dashboard, you can define which regions should be available for the clients.


Available Regions

Photon Cloud has servers in several regions, distributed across multiple hosting centers over the world.

Each Photon Cloud region is identified by a "region token".

List of available regions and tokens:

The strings for region tokens(or codes) are case insensitive. Example: "EU" or "eu" are both accepted and refer to the same Europe region.
RegionHosted inToken
Canada, EastMontrealcae
Chinese Mainland1 (See Instructions)Shanghaicn
Russia, EastKhabarovskrue
South AfricaJohannesburgza
South AmericaSao Paulosa
South KoreaSeoulkr
USA, EastWashington
USA, WestSan Joséusw

1: Chinese Mainland region needs separate AppId and subscription.

Back To Top

Dashboard Regions Filtering

You can filter the list of available Photon Cloud regions per application on the fly directly from the dashboard.

Photon Cloud: Regions Whitelist
Filter Photon Cloud Regions

Go to the dashboard and then click "Manage" for a chosen application and then click "Edit". You will find an input field where you can enter the list of whitelisted regions as follows:

  • the allowed list should be a string of region tokens separated by semicolons. e.g. "eu;us".
  • region tokens are case insensitive and are defined here.
  • undefined or unrecognized region tokens will be ignored from the list.
  • empty ("") or malformed string (e.g. ";;;") means empty list.
  • empty list means all available regions are allowed.

Once you confirm and save, the operation GetRegions will return only the filtered list of regions. Thus, clients should select from that list. Take into consideration that dashboard updates propagation can take up to 10 minutes.

Back To Top

How To Select A Region At Runtime

If you are not using the Best Region option, you may want to let your players choose which region to connect. This can help to lower the ping between players if they are connecting to a common near region or just want to join a session with friends that are playing on a specific region.

The region selection can only be done when Photon Bolt is not running and must be executed before you initialize the PhotonPlatform. We dispose of a list of available regions predefined in the UdpKit.Platform.Photon.PhotonRegion class, that you can use for listing the regions. In the following snippet, we show how you can change the target region in runtime:

public class Menu : Bolt.GlobalEventListener
    // Target Region
    private static int currRegion = 0;

    // List of available Regions
    private PhotonRegion.Regions[] availableRegions = new PhotonRegion.Regions[]

    private void UpdateRegion()
        if (BoltNetwork.IsRunning == false)
            // Get the current Region based on the index
            var targetRegion = PhotonRegion.GetRegion(availableRegions[currRegion]);

            // Update the target region

            // Log the update
            Debug.LogFormat("Update region to {0}", targetRegion.Name);

            // Next time we use the next region

            // Go back to 0
            if (currRegion == availableRegions.Length)
                currRegion = 0;

            // IMPORTANT
            // Initialize the Photon Platform again
            // this will update the internal cached region
            BoltLauncher.SetUdpPlatform(new PhotonPlatform());
            BoltLog.Error("Bolt is running, you can't change region while runnning");

As you can see, every time we call UpdateRegion(), it will pick the next region on the list availableRegions, and use the method BoltRuntimeSettings.instance.UpdateBestRegion to update the region to be used. Keep in mind, that you need to reinitialize the platform, as the region is cached, and will not change if you don't recreate it.

Back To Top

Using The Chinese Mainland Region

You need to request access to the Chinese Mainland region for your Photon application. Send us an email so we could unlock it for your AppID.
You cannot subscribe to paid plans to be used in the Chinese Mainland region via our website. Reach out to us by email to receive a quote for any subscription.

The Photon Name Server has to be local to China, as the firewall might block the traffic otherwise. The Chinese Photon Name Server is "".

Connecting with clients from outside of China mainland will most likely not produce good results. Also, connecting from the Photon servers to servers outside of China mainland (e.g. for Custom Authentication, WebHooks, WebRPCs) might not be reliable.

Important: in the current phase, changes you make to your app via your dashboard are not automatically reflected in the app caches for China. Let us know by email if you have an update request there.

Also, for legal reasons, you need a separate build for China and we recommend using a separate AppId with it. For example, use a compile condition (of your choice) to change the AppId and the Photon Name Server depending on the build.

Follow the instructions corresponding to your client SDK to make a special build for the Chinese market.

To Document Top