Documentation

​
​

Development

User Acquisition

Monetization

Industry

Multiplayer Services SDK

All Services

Multiplayer Services SDK

Multiplayer
​
​
Multiplayer Services SDK
  • Overview
  • Get started
  • Use multiplayer sessions
  • Manage sessions
    • Lobby events
    • Rate limits
    • Information management in sessions
      • Session data and player data
      • Update session data
      • Update player data
      • Manage properties as a host
      • Manage properties as a client
    • Synchronize player names in a session
    • Access control
    • Session error messages
  • Connect players through a relay
  • Networking
  • Matchmaking
  • Monitor and debug sessions
  • Tutorials
  • Reference
  1. Multiplayer Services SDK

Session data and player data

Learn how session and player data are structured and used in Unity Multiplayer Services
Read time 3 minutes
Last updated 3 months ago

Sessions support two types of custom data:
  • Session-scoped data is associated with the entire session and can include fields that are indexed for querying.
  • Player-scoped data is associated with a specific player in a specific lobby. Each player in the lobby can have different set properties.

Limits

Session data
  • Maximum properties: 20
  • Non-indexed: 2 KB / each
  • Indexed: 128 B / each
  • Maximum number of indexed strings: 5
  • Maximum number of indexed numbers: 5
Player data
  • Maximum properties: 10/player
  • Maximum size: 2KB
  • Not indexable

Data access and visibility

There are three levels of access to data:

Public data

  • Data that is visible to anyone, including players who are not in the session.
  • Examples of public data include maps and profile icons.

Member data

  • Data that is only visible to players who have joined the session.

Private data

  • Data that is only visible to an individual player who is in the session.
  • Session data that is only visible to the host, player data that is only visible to the owning player and the host.

Data access table

Depending on a player's role in the session (host, member, or non-member), they have different access restrictions to data:

Role of Player

Write session data

Read session data

Write player data for their player

Write player data for other players

Read player data with the following visibility

Session Host
Yes
Yes:
  • Public
  • Member
  • Private
Yes
No
Yes:
  • Public
  • Member
Session Member
No
Yes:
  • Public
  • Member
Yes
No
Yes:
  • Public
  • Member
Non-member
No
Yes:
  • Public
No
No
Yes
  • Public
Note
Only the host can modify session data. In addition, a player’s data can only be modified by the player themselves.

Copyright © 2026 Unity Technologies
LegalPrivacy PolicyCookiesDocumentation Terms of UseDo Not Sell or Share My Personal InformationYour Privacy Choices (Cookie Settings)

"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S and elsewhere (more info here). Other names or brands are trademarks of their respective owners.

Some pages are machine-translated for convenience, and may contain inaccuracies. In the event of conflicting information, the English version is authoritative.

  • On this page
    • Limits

    • Data access and visibility

      • Public data

      • Member data

      • Private data

      • Data access table


Report a problem with this page