> ## 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.

# XblUserProfile

> XblUserProfile

# XblUserProfile

Represents a user's XBOX Live profile.

## Syntax

```cpp theme={null}
typedef struct XblUserProfile {  
    uint64_t xboxUserId;  
    char appDisplayName[XBL_DISPLAY_NAME_CHAR_SIZE];  
    char appDisplayPictureResizeUri[XBL_DISPLAY_PIC_URL_RAW_CHAR_SIZE];  
    char gameDisplayName[XBL_DISPLAY_NAME_CHAR_SIZE];  
    char gameDisplayPictureResizeUri[XBL_DISPLAY_PIC_URL_RAW_CHAR_SIZE];  
    char gamerscore[XBL_GAMERSCORE_CHAR_SIZE];  
    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];  
} XblUserProfile  
```

### Members

*xboxUserId*\
Type: uint64\_t

The user's XBOX user ID.

*appDisplayName*\
Type: char\[XBL\_DISPLAY\_NAME\_CHAR\_SIZE]

The UTF-8 encoded user's display name to be used in application UI. This will always be the user's gamertag and identical to the gameDisplayName field.

*appDisplayPictureResizeUri*\
Type: char\[XBL\_DISPLAY\_PIC\_URL\_RAW\_CHAR\_SIZE]

UTF-8 encoded Uri for the user's gamer pic. This will always be identical to the gameDisplayPictureResizeUri field. The Uri is a resizable Uri. It can be used to specify one of the following sizes and formats by appending '\&format={format}\&w={width}\&h={height}:<br /> Format: png<br /> Width Height<br /> 64 64<br /> 208 208<br /> 424 424<br />

*gameDisplayName*\
Type: char\[XBL\_DISPLAY\_NAME\_CHAR\_SIZE]

The UTF-8 encoded user's display name to be used in application UI. This will always be the user's gamertag and identical to the appDisplayName field.

*gameDisplayPictureResizeUri*\
Type: char\[XBL\_DISPLAY\_PIC\_URL\_RAW\_CHAR\_SIZE]

UTF-8 encoded Uri for the user's gamer pic. This will always be identical to the appDisplayPictureResizeUri field. The Uri is a resizable Uri. It can be used to specify one of the following sizes and formats by appending '\&format={format}\&w={width}\&h={height}:<br /> Format: png<br /> Width Height<br /> 64 64<br /> 208 208<br /> 424 424<br />

*gamerscore*\
Type: char\[XBL\_GAMERSCORE\_CHAR\_SIZE]

The UTF-8 encoded user's Gamerscore.

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

The UTF-8 encoded user's classic gamertag. This field only uses ASCII characters and does not include a suffix.

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

The UTF-8 encoded modern gamertag for the user. This field uses specific ranges of UTF-8 characters and does not include a suffix. Not guaranteed to be unique.

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

The UTF-8 encoded numeric 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 numeric suffix. Format will be "modernGamertag#suffix". Guaranteed to be no more than 16 rendered characters.

## Argument of

[XblProfileGetUserProfileResult](/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofileresult)\
[XblProfileGetUserProfilesResult](/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesresult)\
[XblProfileGetUserProfilesForSocialGroupResult](/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesforsocialgroupresult)

## Requirements

**Header:** profile\_c.h

## See also

[profile\_c](/reference/live/xsapi-c/profile_c/profile_c_members)


## Related topics

- [XblProfileGetUserProfileResult](/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofileresult.md)
- [XblProfileGetUserProfilesResult](/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesresult.md)
- [XblProfileGetUserProfilesForSocialGroupResult](/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesforsocialgroupresult.md)
- [Best practices and testing for modern gamertags](/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-modern-gamertags-best-practices-and-testing.md)
- [XblProfileGetUserProfileAsync](/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofileasync.md)