New ContentId format for easy thumbnail loading

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:

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:

How can I get a correct texture id without having to put it into a decal?
Have GetUserThumbnailAsync use the new 'rbxthumb://' format
Is there any way to get a picture of a shirt as shown in the catalog from the website?
Character Viewpoint
RbxThumb format support for developer product icons
Getting a Decal's AssetID In-game
New image endpoints that can be used in-game!
Using Roblox Catalog Asset Images
Get animation bundle and emote thumbnail
Open source Roblox ImageID to DecalID converter API
It's Impossible to Get an Image ID From a Decal ID
Images are marked as loaded, but don't appear
Upcoming Change to In-Game Thumbnail URLs
Upcoming Change to In-Game Thumbnail URLs
:GetUserThumbnailAsync() Not working for Roblox to Discord API
How to solve this problem?
How to get catalog image from asset id
Headshot Sizes > Fit them better into imagelabels
Need help with trail image
Anyone know how to get the image of a clothing?
How do i get a accesory image in a image label with a script?
Decal not loading
Plugin not loading in correct game icons?
Using Roblox's API to get the Icon from a game
How to get assetId from accessory itself
How do i make a gui with a avatar in it?
Have GetUserThumbnailAsync use the new 'rbxthumb://' format
Collaborative Editing has arrived!
How can I allow players to insert custom image IDs in my game without this error?
How can I get a high quality image of a roblox hat?
September 2019 Recap: Everything you may have missed
Images Failing To Load, Have To Manually Reload
How to get ProductInfo for packages? (Bundles)
Getting Gamepass icon not working
TextBox enquiries
Open source Roblox ImageID to DecalID converter API
Convert Decal asset id to Image asset id
Load catalog icons

This topic was automatically opened after 13 minutes.

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.


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


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


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?


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


Sounds like you want the AvatarHeadShot thumbnail type.


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


There is a web endpoint that allows you to get the outfit/costume ids.


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.


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?


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.


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


Why the order of parameters is enforced for rbxthumb?

The first of the two options below is much easier to write:


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


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 :smiley:

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


Will avatar busts be supported?


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