> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblLeaderboardRow

> XblLeaderboardRow

# XblLeaderboardRow

Represents a row in a collection of leaderboard items.

## Syntax

```cpp theme={null}
typedef struct XblLeaderboardRow {  
    char gamertag[XBL_GAMERTAG_CHAR_SIZE];  
    char modernGamertag[XBL_MODERN_GAMERTAG_CHAR_SIZE];  
    char modernGamertagSuffix[XBL_MODERN_GAMERTAG_SUFFIX_CHAR_SIZE];  
    char uniqueModernGamertag[XBL_UNIQUE_MODERN_GAMERTAG_CHAR_SIZE];  
    uint64_t xboxUserId;  
    double percentile;  
    uint32_t rank;  
    uint32_t globalRank;  
    const char** columnValues;  
    size_t columnValuesCount;  
} XblLeaderboardRow  
```

### Members

*gamertag*\
Type: char\[XBL\_GAMERTAG\_CHAR\_SIZE]

The UTF-8 encoded gamertag of the player.

*modernGamertag*\
Type: char\[XBL\_MODERN\_GAMERTAG\_CHAR\_SIZE]

The UTF-8 encoded modern gamertag for the player. Not guaranteed to be unique.

*modernGamertagSuffix*\
Type: char\[XBL\_MODERN\_GAMERTAG\_SUFFIX\_CHAR\_SIZE]

The UTF-8 encoded suffix appended to modern gamertag to ensure uniqueness. May be empty in some cases.

*uniqueModernGamertag*\
Type: char\[XBL\_UNIQUE\_MODERN\_GAMERTAG\_CHAR\_SIZE]

The UTF-8 encoded unique modern gamertag and suffix. Format will be "modernGamertag#suffix". Guaranteed to be no more than 16 rendered characters.

*xboxUserId*\
Type: uint64\_t

The XBOX user ID of the player.

*percentile*\
Type: double

The percentile rank of the player.

*rank*\
Type: uint32\_t

The rank of the player.

*globalRank*\
Type: uint32\_t

The global rank of the player. If globalrank is 0, then the user has no global rank.

*columnValues*\
Type: const char\*\*

UTF-8 encoded JSON values for each column in the leaderboard row for the player. This will include the corresponding [XblLeaderboardQuery](/reference/live/xsapi-c/leaderboard_c/structs/xblleaderboardquery)'s **statName**, followed by any of the specified **additionalColumnleaderboardNames** that exist in the row.

*columnValuesCount*\
Type: size\_t

The number of **columnValues**.

## Member of

[XblLeaderboardResult](/reference/live/xsapi-c/leaderboard_c/structs/xblleaderboardresult)

## Requirements

**Header:** leaderboard\_c.h

## See also

[leaderboard\_c](/reference/live/xsapi-c/leaderboard_c/leaderboard_c_members)


## Related topics

- [XblLeaderboardResult](/reference/live/xsapi-c/leaderboard_c/structs/xblleaderboardresult.md)
- [Best practices and testing for modern gamertags](/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-modern-gamertags-best-practices-and-testing.md)
- [Leaderboards](/build/steam-porting-guide/features/steam-leaderboards.md)
- [Quota Leaderboards](/services/playfab/community/leaderboards/quota-leaderboards.md)
- [Create basic leaderboard](/services/playfab/community/leaderboards/create-basic-leaderboard.md)