Assets

Almost everything in Roblox is represented as a cloud-based asset with a unique corresponding ID. This ID is typically in the form of rbxassetid://[ID], which gets applied to various instances as a property that's appropriate for that particular asset type. For example, Texture, MeshPart, and Sound instances reference image, mesh, and audio assets through their respective TextureID, MeshID, and SoundID properties.

A decal asset of a young woman with a button for an eye.An untextured treasure chest MeshPart asset.
rbxassetid://7229442422rbxassetid://6768917255rbxassetid://9125402735

This cloud-based asset system allows you to store assets through Roblox and reuse them across the platform in various contexts, such as in different objects and places, without maintaining local copies as part of each saved Studio experience. You can find millions of project assets in the Creator Store, equip avatar assets in the Marketplace, or you can create your own assets and import them directly into Studio through the asset management tools.

When you import assets, they must pass a moderation check before users can see and interact with them in published experiences. After Roblox approves imported assets, you can choose to retain ownership of their usage on the platform or make them publicly available as detailed in Asset Permissions.

Asset Types

All asset types available on the platform generally fall into one of three categories:

  • Assets that map to project-level items. You can find and configure these assets for specific experiences on the Creator Dashboard.
  • Assets that are objects, or that change the appearance or behavior of objects within places. You can import these assets or find them in the Creator Store.
  • Assets that change the body, clothing, or animation of avatars and non-playable characters. You can find these assets in the Marketplace.

Every asset type works differently depending on where it lives on the platform. See the following sections for information on how to use each asset type for experiences, places, and avatars.

For Experiences

There are three asset types that map to project-level items. These asset types are unique to the experience that they map to, meaning they are non-transferable to other projects.

  • Places — Every experience has one or more places, or individual 3D worlds. Each place is represented by a data model that describes the place's 3D world and logic.
  • Badges — A badges is a special award you can gift users when they meet a goal within an experience, such as completing a difficult objective or playing for a certain amount of time.
  • Passes — A pass is a monetization product that allows you to charge a one-time Robux fee in order for users to access special privileges within an experience, such as entry to a restricted area, an in-experience avatar item, or a permanent power-up.

For Places

In general, there are two categories of asset types for places that you can either import or find in the Creator Store:

  • Assets that exist as objects within the data model, such as models and meshes.
  • Assets that you apply as an object's property, such as audio, images, fonts, and videos.

For more information on both types of these assets for places, such as where and how you can use them in Studio, reference the following table.

Asset TypeDescription
ModelA Model is a container object for geometric groupings such as BaseParts, MeshParts, and other Model objects. Models can also contain objects such as Scripts. Whenever you group objects together in Studio, they automatically become a Model object. For more information, see Models.
MeshA MeshPart is a type of part object that includes a physically-simulated custom mesh. For more information, see Meshes.
AudioA Sound object is an object that emits audio when you apply an audio asset ID within its SoundId property. Where you place the Sound object in the data model changes how and where the sound emits within the experience. For more information, see Audio Assets and Sound Objects.
ImageImages are used in several ways within a place, including textures/decals on parts, UI elements, mesh textures, textures for custom materials, textures for special effects, and more.
FontTextButton, TextLabel, and TextBox objects display typography in a specific style when you apply a font asset ID. You cannot import fonts, but the Creator Store offers over 80 different fonts for your use.
VideoA VideoFrame object displays a video through its Video asset property. See Video Frames for more information.

For Avatars

There are three categories of asset types for avatars that you can find in the Marketplace and equip to avatars:

  • Body Parts — Assets that represent sections of the avatar character model, such as its head, torso, or legs.
  • Clothing and Accessories — Assets that represent clothing and accessories on top of body parts.
  • Animations — Assets that animate the avatar character model, such as how it runs, jumps, or swims.

Every character model contains a HumanoidDescription object with asset IDs for the character's body parts, clothing, accessories, and animations. By default, a user's playable character references their personal Roblox avatar, but you can apply a custom HumanoidDescription if desired. For more information, see Character Appearance.

Packages

Within Studio, you can convert single assets or asset hierarchies into packages and reuse them in multiple experiences, letting you optimize asset management across your entire team or across multiple projects. When a package is updated, you or your team members can update specific copies to the most current version, update all copies across an experience, or set specific copies to auto update.

For more information, see Packages.

Asset Format Strings

Assets are reflected through formatted strings, each of which points to an online file or a file saved to the client's device. The basic structure is a protocol followed by :// and a string that varies according to the protocol.

[Protocol]://[String]

rbxassetid

rbxassetid points to a user-uploaded asset on Roblox. This format is a common standard for properties such as Decal.Texture, ParticleEmitter.Texture, and Sound.SoundId.

rbxassetid://7229442422

A decal asset of a young woman with a button for an eye.
rbxassetid://3845386987

Three particle emitters emit red, blue, and yellow particles over jar assets that sit on top of a stone tower. The red particles are highlighted.
rbxassetid://9125402735

rbxasset

rbxasset points to Roblox's content folder on the user's device, for example:

rbxasset://textures/face.png

The content folder's location depends on the user's operating system:

%localappdata%\Roblox\Versions\<version>\content

rbxthumb

rbxthumb points to a thumbnail image for the provided asset. Its string format takes a thumbnail type (type), an asset ID (id), and width/height (w/h).

rbxthumb://type=Asset&id=24813339&w=150&h=150

Type (type)Expected id ValueSupported Sizes (w×h)
AssetID for a 2D or 3D asset150×150, 420×420
AvatarID for a Roblox user (Player.UserId)48×48, 60×60, 100×100, 150×150, 180×180, 352×352, 420×420, 720×720
AvatarBustID for a Roblox user (Player.UserId)50×50, 60×60, 75×75, 100×100, 150×150, 180×180, 352×352, 420×420
AvatarHeadShotID for a Roblox user (Player.UserId)48×48, 60×60, 100×100, 150×150, 180×180, 352×352, 420×420
BadgeIconID for a badge150×150
BundleThumbnailID for a Marketplace bundle such as a character, head, or shoes150×150, 420×420
FontFamilyID for a font in the Creator Store or Toolbox inventory1200×80
GameIconID for an experience (DataModel.GameId); shows the experience's icon50×50, 150×150
GamePassID for a pass150×150
GameThumbnailID for an experience (DataModel.GameId); shows the experience's primary thumbnail256×144, 384×216, 480×270, 576×324, 768×432
GroupIconID for a group150×150, 420×420
OutfitID gathered from an OutfitPages table150×150, 420×420
Apply Avatar Head Shot Thumbnail

local Players = game:GetService("Players")
local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local screenGui = Instance.new("ScreenGui")
screenGui.Parent = playerGui
local imageLabel = Instance.new("ImageLabel")
imageLabel.AnchorPoint = Vector2.new(0, 0)
imageLabel.Size = UDim2.new(0, 150, 0, 150)
imageLabel.Position = UDim2.new(0, 16, 0, 16)
imageLabel.BorderSizePixel = 0
imageLabel.BackgroundColor3 = Color3.new(0, 0, 0)
imageLabel.BackgroundTransparency = 0.8
imageLabel.Parent = screenGui
local success, content, isReady = pcall(function()
return Players:GetUserThumbnailAsync(player.UserId, Enum.ThumbnailType.HeadShot, Enum.ThumbnailSize.Size352x352)
end)
if success then
-- Apply thumbnail content to image label
imageLabel.Image = content
-- Crop thumbnail to circle
local corner = Instance.new("UICorner")
corner.CornerRadius = UDim.new(1, 0)
corner.Parent = imageLabel
end

rbxhttp

rbxhttp is shorthand for ContentProvider.BaseUrl, for example:

rbxhttp://Thumbs/Avatar.ashx?x=100&y=100&format=png

https / http

https or http points to the exact location of something on the internet. It only works on Roblox-approved domains and raises an error if you use it elsewhere.

https://www.roblox.com/asset/?id=9723979220

Asset Permissions

An asset's privacy status determines who has permission to use the asset within their experiences. By default, all assets are private when you or your group members import them into Studio. If you want to grant everyone access to the asset ID, you must distribute the asset to the Creator Store.

Asset Moderation

Roblox performs both human and automated asset moderation on a proactive and reactive basis to ensure assets adhere to the Community Rules, Terms of Use, and Digital Millennium Copyright Act (DMCA). If any asset violates these moderation policies, such as including discriminatory or adult content, the Moderation team flags and removes the asset to protect users from harmful or non-compliant content. This process generally happens within a few hours after you import the asset.

If an asset is still in the moderation queue when you publish your experience, users cannot see or interact with the asset until Roblox approves it. If the asset doesn't pass moderation, you will receive a notification explaining why the asset cannot be on the platform in its current state. For more information, see Working with Assets - Asset Moderation.

Asset Management

Roblox offers several tools to import, store, and publish your assets:

ToolDescription
Asset ManagerImports and stores images, meshes, packages, audio, and models. Only displays assets that you've imported into the currently opened experience.
ToolboxStores every asset that you or your groups have ever imported into Studio, regardless of what experience you currently have open. Also includes assets from the Creator Store, allowing you to quickly drop user-generated assets directly into your experiences.
3D ImporterImports .fbx or .obj 3D models from third-party modeling tools as a custom Model instance.

Archiving Assets

To further help with organization, you can archive most asset types in the Development Items section of the Creator Dashboard.

Development Items section on the Creator Dashboard A close up view of a Splash Ring asset. The ellipsis button and the Archive menu item are highlighted.

After you archive an asset, it disappears from the website and is no longer usable or visible in Roblox experiences, including your own.