New ContentId format for easy thumbnail loading

[TheGamer101]

Hello Developers,

RbxThumb is a new ContentId format that allows easy loading of thumbnails. It works everywhere you would expect image ContentIds to work including in ImageLabel.Image and ContentProvider:PreloadAsync.

The format for an RbxThumb contentId is “rbxthumb://type=[ThumbnailType]&id=[TargetId]&w=[Width]&h=[Height]”. The order of parameters is enforced.

For example, if you wanted an ImageLabel with a thumbnail of my lovely avatar on it you would set the Image property to:
rbxthumb://type=Avatar&id=2231221&w=720&h=720

Supported thumbnail types and sizes:

Type:               Supported Sizes:
"Asset"             150x150, 420x420
"Avatar"            100x100, 352x352, 720x720
"AvatarHeadShot"    48x48,   60x60,   150x150
"BadgeIcon"         150x150
"BundleThumbnail"   150x150, 420x420
"GameIcon"          50x50,   150x150
"GamePass"          150x150
"GroupIcon"         150x150, 420x420
"Outfit"            150x150, 420x420

RbxThumb automatically batches thumbnail requests together so loading them is more efficient. Thumbnails that are not yet ready are automatically retried up to 3 times.

For more documentation, see the rbxthumb section here:

Create on Roblox

[Craftero]

This new ContentID will be great for loading thumbnail icons directly from their source! I can see myself using this in a number of different situations.

I may be out of the loop but I was wondering what exactly the “Outfit” thumbnail type relates to? I can’t seem to find any documentation specifically explaining the term on the Developer Hub.

Is the “Outfit” thumbnail type synonymous with what are now known as “Costumes”? If that’s the case, how would one load a specific costume? I’m not aware of a method of retrieving specific costume IDs.

[p0s_0 (pos0)]

Will there be a property in the Image URL of an avatar to just have the face or is that already a feature?

[alex_ander]

I’m pretty sure the “Outfit” thumbnail is the image of the saved outfit you want to load? Little confused on what you were trying to ask but I think that’s what you meant

[Avallachi]

Hello. Previously attempting to load a newly changed avatar’s thumbnail resulted in an error or a white image. This is a big problem for UIs that depend on it. Is this now fixed, or is it just not possible to fix?

[ReturnedTrue (Tr_uth)]

Does Players service’s :GetUserThumbnailAsync() now return a rbxthumb URL?

[TheGamer101]

@OldBo5

Will there be a property in the Image URL of an avatar to just have the face or is that already a feature?

Sounds like you want the AvatarHeadShot thumbnail type.

[p0s_0 (pos0)]

Alright, thanks alot! Will keep this in mind next time I need this.

[TheGamer101]

@Craftero

Is the “Outfit” thumbnail type synonymous with what are now known are “Costumes”? If that’s the case, how would one load a specific costume? I’m not aware of a way of retrieving specific Costume IDs.

There is a web endpoint that allows you to get the outfit/costume ids. https://avatar.roblox.com/v1/users/2231221/outfits

[Craftero]

Oh, I wasn’t aware of that. That makes a bit more sense. Thanks for clearing that up!

I’m still a little confused as to how the Outfit thumbnail type could be practically used but perhaps its use cases are beyond my current level of scripting experience.

[TheNexusAvenger (Nexus)]

Is there a reason the selection of sizes is so limited? As an example, the game icons uploaded to Roblox can be 1080x1080 for Xbox, but the API only shows 50x50 and 150x150. Also, the sizes are very inconsistent, like Avatar being the only one with 352x352 and AvatarHeadShot being the only ones with 48x48 and 60x60?

[TheGamer101]

I think the max size for GameIcons is 1024x1024. We plan on adding sizes 512x512, 256x256 and 128x128 for GameIcons. The sizes are mostly picked based on sizes we want to use internally and the most common size currently in use. If we allowed many more sizes the chances that a requested size was not already generated would be increased.

[Polyhex]

This is so much better/more concise than the ones we had to use previously, thank you!

[acreol]

Why the order of parameters is enforced for rbxthumb?

The first of the two options below is much easier to write:
'rbxthumb://type=Avatar&w=100&h=100&id='..uid
'rbxthumb://type=Avatar&id='..uid..'&w=100&h=100'

[DevSpec (iJava)]

I agree - I don’t see any reason to enforce the order of parameters.

[Mr_Vgy]

Will old endpoints be deprecated anytime soon? A lot of older content I have relies on those.
Also this seems like a much better and more uniform system so I look forward to using it more soon

These are some of the endpoints I’m talking about:

New image endpoints that can be used in-game!

[image] https://www.roblox.com/bust-thumbnail/image?userId=48103520&width=420&height=420&format=png https://www.roblox.com/headshot-thumbnail/image?userId=48103520&width=420&height=420&format=png https://www.roblox.com/outfit-thumbnail/image?userOutfitId=26415539&width=420&height=420&format=png https://www.roblox.com/asset-thumbnail/image?assetId=26769281&width=420&height=420&format=png These image four endpoints are now usable as textures in-game, enjoy! EDIT rbxthumb content I…

[VyrissDev (Vyriss)]

Will avatar busts be supported?

[SoCalifornian (Cali)]

rbxthumb:// is translated to what url wise? We’re given the urls for rbxassetid:// and others on the wiki, how about this one?