Learn
Engine Class
HumanoidDescription


API Reference
Properties
AccessoryBlob
Not Replicated
Not Scriptable
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.AccessoryBlob:string

BackAccessory
Not Replicated
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.BackAccessory:string

BodyTypeScale
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.BodyTypeScale:number

ClimbAnimation
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.ClimbAnimation:number

DepthScale
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.DepthScale:number

Face
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.Face:number

FaceAccessory
Not Replicated
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.FaceAccessory:string

FallAnimation
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.FallAnimation:number

FrontAccessory
Not Replicated
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.FrontAccessory:string

GraphicTShirt
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.GraphicTShirt:number

HairAccessory
Not Replicated
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.HairAccessory:string

HatAccessory
Not Replicated
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.HatAccessory:string

Head
Not Replicated
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.Head:number

HeadColor
Not Replicated
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.HeadColor:Color3

HeadScale
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.HeadScale:number

HeightScale
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.HeightScale:number

IdleAnimation
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.IdleAnimation:number

JumpAnimation
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.JumpAnimation:number

LeftArm
Not Replicated
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.LeftArm:number

LeftArmColor
Not Replicated
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.LeftArmColor:Color3

LeftLeg
Not Replicated
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.LeftLeg:number

LeftLegColor
Not Replicated
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.LeftLegColor:Color3

MoodAnimation
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.MoodAnimation:number

NeckAccessory
Not Replicated
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.NeckAccessory:string

Pants
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.Pants:number

ProportionScale
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.ProportionScale:number

RightArm
Not Replicated
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.RightArm:number

RightArmColor
Not Replicated
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.RightArmColor:Color3

RightLeg
Not Replicated
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.RightLeg:number

RightLegColor
Not Replicated
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.RightLegColor:Color3

RunAnimation
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.RunAnimation:number

Shirt
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.Shirt:number

ShouldersAccessory
Not Replicated
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.ShouldersAccessory:string

StaticFacialAnimation
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.StaticFacialAnimation:boolean

SwimAnimation
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.SwimAnimation:number

Torso
Not Replicated
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.Torso:number

TorsoColor
Not Replicated
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.TorsoColor:Color3

UseAvatarSettings
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.UseAvatarSettings:boolean

WaistAccessory
Not Replicated
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.WaistAccessory:string

WalkAnimation
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.WalkAnimation:number

WidthScale
Read Parallel
Capabilities: AvatarAppearance
HumanoidDescription.WidthScale:number

Methods
AddEmote
Capabilities: AvatarAppearance
HumanoidDescription:AddEmote(
name:string, assetId:number
):()
Parameters
name:string
assetId:number
Returns
()

GetAccessories
Capabilities: AvatarAppearance
HumanoidDescription:GetAccessories(includeRigidAccessories:boolean):{AccessoriesInfo}
Parameters
includeRigidAccessories:boolean
Returns
{AccessoriesInfo}
Code Samples
Get Accessories
local includeRigidAccessories = true
local accessoriesTable =
game:GetService("Players"):GetHumanoidDescriptionFromUserIdAsync(1):GetAccessories(includeRigidAccessories)
for _, accessoryInfo in ipairs(accessoriesTable) do
print(tostring(accessoryInfo.AssetId) .. " " .. tostring(accessoryInfo.AccessoryType))
end

GetEmotes
Capabilities: AvatarAppearance
HumanoidDescription:GetEmotes():Dictionary
Returns

GetEquippedEmotes
Capabilities: AvatarAppearance
HumanoidDescription:GetEquippedEmotes():{any}
Returns

RemoveEmote
Capabilities: AvatarAppearance
HumanoidDescription:RemoveEmote(name:string):()
Parameters
name:string
Returns
()

SetAccessories
Capabilities: AvatarAppearance
HumanoidDescription:SetAccessories(
accessories:{any}, includeRigidAccessories:boolean
):()
Parameters
accessories:{any}
includeRigidAccessories:boolean
Returns
()
Code Samples
Set Accessories
local humanoidDescription = Instance.new("HumanoidDescription")
local originalSpecifications = {
{
Order = 1,
AssetId = 123456789,
Puffiness = 0.5,
AccessoryType = Enum.AccessoryType.Sweater,
},
}
humanoidDescription:SetAccessories(originalSpecifications)
local updatedSpecifications = humanoidDescription:GetAccessories(false)
local newIndividualSpecification = {
Order = 2,
AssetId = 987654321,
Puffiness = 0.7,
AccessoryType = Enum.AccessoryType.Jacket,
IsLayered = true,
}
updatedSpecifications[#updatedSpecifications + 1] = newIndividualSpecification
humanoidDescription:SetAccessories(updatedSpecifications)

SetEmotes
Capabilities: AvatarAppearance
HumanoidDescription:SetEmotes(emotes:Dictionary):()
Parameters
emotes:Dictionary
Returns
()

SetEquippedEmotes
Capabilities: AvatarAppearance
HumanoidDescription:SetEquippedEmotes(equippedEmotes:{any}):()
Parameters
equippedEmotes:{any}
Returns
()

Events
EmotesChanged
Capabilities: AvatarAppearance
HumanoidDescription.EmotesChanged(newEmotes:Dictionary):RBXScriptSignal
Parameters
newEmotes:Dictionary

EquippedEmotesChanged
Capabilities: AvatarAppearance
HumanoidDescription.EquippedEmotesChanged(newEquippedEmotes:{any}):RBXScriptSignal
Parameters
newEquippedEmotes:{any}

©2026 Roblox Corporation. Roblox, the Roblox logo and Powering Imagination are among our registered and unregistered trademarks in the U.S. and other countries.