**HumanoidDescription** is an object that stores a description of a
`Class.Humanoid` for R6 and R15 rigs. It can be
`Class.Humanoid:ApplyDescription()|applied` in order to set a rig's scaling,
clothing (`Class.Shirt`, `Class.Pants`, `Class.ShirtGraphic`),
`Class.Accessory|Accessories`, `Class.Animation|Animations` and
`Class.BodyColors`.

You can get a HumanoidDescription by using the following functions:

- `Class.Players:GetHumanoidDescriptionFromUserId()`, for an outfit currently
  being worn by a user on Roblox.
- `Class.Players:GetHumanoidDescriptionFromOutfitId()`, for an outfit created
  by a user on Roblox.
- You can create a Humanoid rig model from a HumanoidDescription through
  `Class.Players:CreateHumanoidModelFromDescription()`.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.


**EmotesChanged** fires when emotes are
`Class.HumanoidDescription:AddEmote()|added`,
`Class.HumanoidDescription:RemoveEmote()|removed` or
`Class.HumanoidDescription:SetEmotes()|set` on the description. The event
fires with the new emote table as returned by
`Class.HumanoidDescription:GetEmotes()|GetEmotes`.

If `Class.HumanoidDescription:AddEmote()|AddEmote` is called with the same
name and ID as an existing emote, this event fires.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription:AddEmote()|AddEmote`,
  `Class.HumanoidDescription:RemoveEmote()|RemoveEmote` and
  `Class.HumanoidDescription:SetEmotes()`, which can cause this event to
  be fired


HumanoidDescription.EmotesChanged

newEmotes

A dictionary of emotes where the key is the emote name and the value
is an array of emote asset IDs. Example:

```lua
{
    Salute = {3360689775},
    Agree = {4849487550},
    Disagree = {4849495710}
}
```

.


Fires when emotes are added, removed or set on this description.


**EquippedEmotesChanged** fires when the equipped emotes are set on this
description using
`Class.HumanoidDescription:SetEquippedEmotes()|SetEquippedEmotes`. It
provides the new equipped emotes in a table like that returned by
`Class.HumanoidDescription:GetEquippedEmotes()|GetEquippedEmotes`.

#### Example

```lua
local hd = Instance.new("HumanoidDescription")
hd.EquippedEmotesChanged:Connect(function(equippedEmotes)
    print(("We have %d emotes equipped"):format(#equippedEmotes))
    for _, t in equippedEmotes do
        print(("In slot %d: emote %s is equipped"):format(t.Slot, t.Name))
    end
end)
hd:SetEquippedEmotes({"Salute", "Agree"}) --> We have 2 emotes equipped
```

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription:SetEquippedEmotes()|SetEquippedEmotes`, which
  fires this event
- `Class.HumanoidDescription:GetEquippedEmotes()|GetEquippedEmotes`, which
  can be used to query the currently equipped emotes without this event
  firing


HumanoidDescription.EquippedEmotesChanged

newEquippedEmotes

An array of tables describing the name and slot which each emote is
equipped. Example:

```lua
{
    {Slot = 3, Name = "Salute"},
    {Slot = 2, Name = "Agree"},
    {Slot = 1, Name = "Disagree"},
}
```

.


Fires when the equipped emotes are
`Class.HumanoidDescription:SetEquippedEmotes()|set` on this description.


**AddEmote** will add an Emote asset to the description given a name and
its asset ID. The asset ID must be for an "Emote" asset (see
[Featured emotes](https://www.roblox.com/catalog?Category=0&Subcategory=39)
in the Catalog).

You can add multiple emotes of the same name. All emotes of the same name
can be removed using
`Class.HumanoidDescription:RemoveEmote()|RemoveEmote`. If an emote with
the same ID is added under the same name,
`Class.HumanoidDescription.EmotesChanged|EmotesChanged` fires.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription:GetEmotes()|GetEmotes`, which can be used to
  retrieve the emotes that have been added by this function
- `Class.HumanoidDescription:SetEmotes()|SetEmotes` and
  `Class.HumanoidDescription:RemoveEmote()|RemoveEmote`, which also
  manipulate what emotes have been added
- `Class.HumanoidDescription.EmotesChanged|EmotesChanged`, which fires
  after this function is called


HumanoidDescription:AddEmote

name

A string that identifies what emote is being added. Example:
`"Salute"`.


assetId

Adds the emote to the description given a name and its asset ID.


This code sample prints out all the asset IDs and types of the accessories in
the HumanoidDescription.

Returns a table of an avatar's current accessories. If the second
parameter (includeRigidAccessories) is true then the returned table will
also include entries for rigid accessories from the rigid accessory
properties.


HumanoidDescription:GetAccessories

includeRigidAccessories

Set to true if rigid accessories from the rigid accessory properties
should also be included in the return array. False means only include
layered clothing accessories from the AccessoryBlob.


Returns an array where each entry specifies for an individual
accessory the AccessoryType, AssetId, IsLayered, Order and Puffiness.


Returns a table of an avatar's current accessories.


**GetEmotes** returns a dictionary of emotes that have been
`Class.HumanoidDescription:AddEmote()|added` or
`Class.HumanoidDescription:SetEmotes()|set` to this description. The keys
of this dictionary are the names of the emotes, and the values are a
non-empty array of emote IDs for that name.

#### Example

```lua
local hd = Instance.new("HumanoidDescription")
hd:AddEmote("Salute", 3360689775)
local emotes = hd:GetEmotes()
for name, ids in emotes do
    print(("The emote %s has %d ids:"):format(name, #ids))
    for _, id in ids do
        print(id)
    end
end
```

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription:SetEmotes()|SetEmotes` and
  `Class.HumanoidDescription:AddEmote()|AddEmote`, which can add emotes
  that may be returned by this function
- `Class.HumanoidDescription.EmotesChanged|EmotesChanged`, which fires
  with the value returned this function after it may have changed


HumanoidDescription:GetEmotes

Returns a dictionary of emotes that have been
`Class.HumanoidDescription:AddEmote()|added` or
`Class.HumanoidDescription:SetEmotes()|set` to this description.


**GetEquippedEmotes** returns an array of tables which indicate the `Name`
and `Slot` of each equipped emote as it was set by
`Class.HumanoidDescription:SetEquippedEmotes()|SetEquippedEmotes`.

#### Example

```lua
local hd = Instance.new("HumanoidDescription")
hd:SetEmotes({Salute = {3360689775}, Agree = {4849487550}})
hd:SetEquippedEmotes({"Salute", "Agree"})
-- Iterate over the equipped emotes:
for _, t in hd:GetEquippedEmotes() do
    print(("In slot %d: emote %s is equipped"):format(t.Slot, t.Name))
end
```

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription:SetEquippedEmotes()|SetEquippedEmotes`, which
  sets the currently equipped emotes and changes what this function
  returns
- `Class.HumanoidDescription.EquippedEmotesChanged|EquippedEmotesChanged`,
  which fires when the function returned by this value may have changed


HumanoidDescription:GetEquippedEmotes

Returns an array of tables describing the equipped emotes that have been
`Class.HumanoidDescription:SetEquippedEmotes()|set`.


**RemoveEmote** removes all emotes from the description that have been
`Class.HumanoidDescription:AddEmote()|added` or
`Class.HumanoidDescription:SetEmotes()|set` under the given name. If there
are no added emotes with the given name, no error is thrown and
`Class.HumanoidDescription.EmotesChanged|EmotesChanged` **does not** fire.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription:SetEmotes()|SetEmotes` and
  `Class.HumanoidDescription:AddEmote()|AddEmote`, which can add emotes
  that may be removed
- `Class.HumanoidDescription:GetEmotes()|GetEmotes`, which can retrieve a
  dictionary of emotes that may be removed


HumanoidDescription:RemoveEmote

The name of the emote as it was
`Class.HumanoidDescription:SetEmotes()|set` or
`Class.HumanoidDescription:AddEmote()|added`.


Removes any emotes that have been added under the given name.


This code sample adds two accessories to a HumanoidDescription.

Accepts a table that sets the accessories and related properties for an
avatar. If the second parameter (includeRigidAccessories) is true, then
this function can also be used to set the rigid accessories in the rigid
accessory properties. In this case any table entry that does not have an
Order will be considered a rigid accessory and put in the appropriate
property according to the AccessoryType.


HumanoidDescription:SetAccessories

accessories

Each entry specifies for an individual accessory the AccessoryType,
AssetId, IsLayered, Order and Puffiness.


Set to true if rigid accessories are also included in the passed in
array (they would have to not specify Order).


Accepts a table that sets the accessories and related properties for an
avatar.


**SetEmotes** sets all of the emotes on this description given a table
similar to that returned by
`Class.HumanoidDescription:GetEmotes()|GetEmotes`. It fires
`Class.HumanoidDescription.EmotesChanged|EmotesChanged`

#### Example

```lua
local emotes = {
    Salute = {3360689775}, -- Syntax note: can also use ["Salute"] = ...
    Agree = {4849487550},
    Disagree = {4849495710}
}
local hd = Instance.new("HumanoidDescription")
hd:SetEmotes(emotes)
```

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription:AddEmote()|AddEmote` and
  `Class.HumanoidDescription:RemoveEmote()|RemoveEmote` which can modify
  the added emotes on an individual level
- `Class.HumanoidDescription.EmotesChanged|EmotesChanged`, which fires
  when this function is called


HumanoidDescription:SetEmotes

emotes

Sets all of the emotes on this description.


**SetEquippedEmotes** sets the currently equipped emotes given an array of
emote names as they were passed to
`Class.HumanoidDescription:AddEmote()|AddEmote` or
`Class.HumanoidDescription:SetEmotes()|SetEmotes`. It can also take an
array of tables similar to that returned by
`Class.HumanoidDescription:GetEquippedEmotes()|GetEquippedEmotes`. Calling
this function fires
`Class.HumanoidDescription.EquippedEmotesChanged|EquippedEmotesChanged`.

#### Example

```lua
local hd = Instance.new("HumanoidDescription")
hd:SetEmotes({Salute = {3360689775}, Agree = {4849487550}})
-- Can provide either an array of strings... (index is slot number)
hd:SetEquippedEmotes({"Salute", "Agree"})
-- ...or an array of tables as returned by GetEquippedEmotes (Slot and Name keys set)
hd:SetEquippedEmotes({{Slot = 1, Name = "Salute"}, {Slot = 2, Name = "Agree"}})
```

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription:GetEquippedEmotes()|GetEquippedEmotes`, which
  returns a value describing the equipped emotes set by this function
- `Class.HumanoidDescription.EquippedEmotesChanged|EquippedEmotesChanged`,
  which fires when this function is called


HumanoidDescription:SetEquippedEmotes

equippedEmotes

An array of emote names. Example:

```lua
{ "Disagree", "Agree", "Salute" }
```

&ndash; OR &ndash; An array of tables describing the name and slot
which each emote is equipped. Example:

```lua
{
    {Slot = 3, Name = "Salute"},
    {Slot = 2, Name = "Agree"},
    {Slot = 1, Name = "Disagree"},
}
```

.


Sets the currently equipped emotes given an array of emote names.


HumanoidDescription

A JSON formatted array of Layered clothing where each table in the entry
in the array describes an accessory's AssetId, AccessoryType, Order, and
(optionally) Puffiness as key-value pairs. This can be edited in the
properties windows for the `Class.HumanoidDescription`.

To make changes from Luau (which is recommended over editing the JSON
directly), use `Class.HumanoidDescription:SetAccessories()` and
`Class.HumanoidDescription:GetAccessories()`. These methods can also be
enabled to work with rigid accessories by setting IncludeRigidAccessories
parameters to true.


HumanoidDescription.AccessoryBlob

A JSON formatted array of Layered clothing where each table in the entry
in the array describes an accessory's AssetId, AccessoryType, Order, and
(optionally) Puffiness as key-value pairs.


**BackAccessory** is a comma-separated list of asset IDs that determine
what accessories should be added when the description is
`Class.Humanoid:ApplyDescription()|applied`. The list cannot contain
duplicates.

An error is thrown if you try to apply a new description which shares any
assets with the existing description but a different accessory property.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.FaceAccessory|FaceAccessory`,
  `Class.HumanoidDescription.FrontAccessory|FrontAccessory`,
  `Class.HumanoidDescription.HairAccessory|HairAccessory`,
  `Class.HumanoidDescription.HatAccessory|HatAccessory`,
  `Class.HumanoidDescription.NeckAccessory|NeckAccessory`,
  `Class.HumanoidDescription.ShouldersAccessory|ShouldersAccessory` and
  `Class.HumanoidDescription.WaistAccessory|WaistAccessory`, which are
  similar properties that apply accessories like this one


HumanoidDescription.BackAccessory

A comma-separated list of asset IDs that will be added as
`Class.Accessory|Accessories` to a `Class.Humanoid` rig when
`Class.Humanoid:ApplyDescription()|applied`, usually those attached to its
back (such as capes).


**BodyTypeScale** determines the factor by which the shape of a
`Class.Humanoid` is interpolated from the standard R15 body shape (0) to a
taller and more slender body type (1). Values outside the range of 0 to 1
are clamped. When the description is applied through
`Class.Humanoid:ApplyDescription()`, this value maps to a
**BodyTypeScale** `Class.NumberValue` within the `Class.Humanoid`.

Note that when the value of this property is 0, the
`Class.HumanoidDescription.ProportionScale|ProportionScale` property has
no effect.

#### See Also

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.ProportionScale|ProportionScale`, which also
  affects rig proportions when this property is non-zero
- `Class.HumanoidDescription.HeightScale|WidthScale`,
  `Class.HumanoidDescription.DepthScale|HeightScale` and
  `Class.HumanoidDescription.DepthScale|DepthScale`, which provide finer
  control over the dimensions of a rig
- `Class.HumanoidDescription.HeadScale|HeadScale`, which provides specific
  control over the scale of the rig's head


HumanoidDescription.BodyTypeScale

Determines the factor by which the shape of a `Class.Humanoid` is
interpolated from the standard R15 body shape (0) to a taller and more
slender body type (1).


When this description is `Class.Humanoid:ApplyDescription()|applied` to a
`Class.Humanoid`, **ClimbAnimation** determines the
`Class.Animation.AnimationId` to play when its
`Class.Humanoid:GetState()|state` is `Enum.HumanoidStateType|Climbing`.

See also:

- `Class.HumanoidDescription.FallAnimation|FallAnimation`,
  `Class.HumanoidDescription.IdleAnimation|IdleAnimation`,
  `Class.HumanoidDescription.JumpAnimation|JumpAnimation`,
  `Class.HumanoidDescription.RunAnimation|RunAnimation`,
  `Class.HumanoidDescription.SwimAnimation|SwimAnimation` and
  `Class.HumanoidDescription.WalkAnimation|WalkAnimation`, which are
  similar properties that determine animations to play on the rig


HumanoidDescription.ClimbAnimation

When this description is `Class.Humanoid:ApplyDescription()|applied` to a
`Class.Humanoid`, this determines the `Class.Animation.AnimationId` to
play when its `Class.Humanoid:GetState()|state` is
`Enum.HumanoidStateType|Climbing`.


**DepthScale** determines by what factor the depth (back-to-front
distance) of a `Class.Humanoid` is scaled, as well as all accessories not
attached to its head. When the description is applied through
`Class.Humanoid:ApplyDescription()`, this value maps to a
**BodyDepthScale** `Class.NumberValue` within the Humanoid.

#### See Also

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.BodyTypeScale|BodyTypeScale` and
  `Class.HumanoidDescription.ProportionScale|ProportionScale`, which can
  provide more realistic rig proportions
- `Class.HumanoidDescription.HeightScale|WidthScale` and
  `Class.HumanoidDescription.DepthScale|HeightScale`


HumanoidDescription.DepthScale

Determines by what factor the depth (back-to-front distance) of a
`Class.Humanoid` is scaled.


**Face** determines the asset ID of the Face to be
`Class.Humanoid:ApplyDescription()|applied` to a `Class.Humanoid`. The
type of the asset ID provided **must be for a Face** type asset and not a
Decal or Image type asset.

The actual face texture is rendered using a `Class.Decal` in the Head
named "face" or "Face".

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.GraphicTShirt|GraphicTShirt`,
  `Class.HumanoidDescription.Shirt|Shirt` and
  `Class.HumanoidDescription.Pants|Pants`, which also apply textures to a
  rig
- `Class.HumanoidDescription.Head|Head`, which can change the mesh of the
  head
- `Class.HumanoidDescription.FaceAccessory|FaceAccessory`, which can apply
  one or more `Class.Accessory` objects to the face


HumanoidDescription.Face

Determines the asset ID of the Face to be applied to the `Class.Humanoid`.


**FaceAccessory** is a comma-separated list of asset IDs that determine
what accessories should be added when the description is
`Class.Humanoid:ApplyDescription()|applied`, usually those attached to the
front of its face (such as glasses). The list does not contain duplicates.

An error is thrown if you try to apply a new description which shares any
assets with the existing description but a different accessory property.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.BackAccessory|BackAccessory`,
  `Class.HumanoidDescription.FrontAccessory|FrontAccessory`,
  `Class.HumanoidDescription.HairAccessory|HairAccessory`,
  `Class.HumanoidDescription.HatAccessory|HatAccessory`,
  `Class.HumanoidDescription.NeckAccessory|NeckAccessory`,
  `Class.HumanoidDescription.ShouldersAccessory|ShouldersAccessory` and
  `Class.HumanoidDescription.WaistAccessory|WaistAccessory`, which are
  similar properties that apply accessories like this one
- `Class.HumanoidDescription.Face|Face`, a property that determines what
  Face texture is used on the head


HumanoidDescription.FaceAccessory

A comma-separated list of asset IDs that will be added as
`Class.Accessory|Accessories` to a `Class.Humanoid` rig when
`Class.Humanoid:ApplyDescription()|applied`, usually those attached to the
front of its face (such as glasses).


When this description is `Class.Humanoid:ApplyDescription()|applied` to a
`Class.Humanoid`, **FallAnimation** determines the
`Class.Animation.AnimationId` to play when its
`Class.Humanoid:GetState()|state` is `Enum.HumanoidStateType|Freefall`.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.FallAnimation|ClimbAnimation`,
  `Class.HumanoidDescription.IdleAnimation|IdleAnimation`,
  `Class.HumanoidDescription.JumpAnimation|JumpAnimation`,
  `Class.HumanoidDescription.RunAnimation|RunAnimation`,
  `Class.HumanoidDescription.SwimAnimation|SwimAnimation` and
  `Class.HumanoidDescription.WalkAnimation|WalkAnimation`, which are
  similar properties that determine animations to play on the rig


HumanoidDescription.FallAnimation

When this description is `Class.Humanoid:ApplyDescription()|applied` to a
`Class.Humanoid`, this determines the `Class.Animation.AnimationId` to
play when its `Class.Humanoid:GetState()|state` is
`Enum.HumanoidStateType|Freefall`.


**FrontAccessory** is a comma-separated list of asset IDs that determine
what accessories should be added when the description is
`Class.Humanoid:ApplyDescription()|applied`, usually those attached to
front of its torso (such as medals or ties). The list does not contain
duplicates.

An error is thrown if you try to apply a new description which shares any
assets with the existing description but a different accessory property.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.BackAccessory|BackAccessory`,
  `Class.HumanoidDescription.FaceAccessory|FaceAccessory`,
  `Class.HumanoidDescription.HairAccessory|HairAccessory`,
  `Class.HumanoidDescription.HatAccessory|HatAccessory`,
  `Class.HumanoidDescription.NeckAccessory|NeckAccessory`,
  `Class.HumanoidDescription.ShouldersAccessory|ShouldersAccessory` and
  `Class.HumanoidDescription.WaistAccessory|WaistAccessory`, which are
  similar properties that apply accessories like this one


HumanoidDescription.FrontAccessory

A comma-separated list of asset IDs that will be added as
`Class.Accessory|Accessories` to a `Class.Humanoid` rig when
`Class.Humanoid:ApplyDescription()|applied`, usually those attached to
front of its torso (such as medals or ties).


**GraphicTShirt** determines the `Class.ShirtGraphic.Graphic|Graphic` used
by a `Class.ShirtGraphic` instance when
`Class.Humanoid:ApplyDescription()` is called on a `Class.Humanoid`. The
asset type must be for a **T‑Shirt**, not a **Decal** or **Image**.

#### See Also

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.Shirt|Shirt`, which can provide the same
  functionality in addition to providing textures for the entire torso and
  arms
- `Class.HumanoidDescription.TorsoColor|TorsoColor`, which can change the
  color of the torso underneath the t-shirt texture


HumanoidDescription.GraphicTShirt

Determines the `Class.ShirtGraphic.Graphic|Graphic` used by a
`Class.ShirtGraphic`.


**HairAccessory** is a comma-separated list of asset IDs that determine
what accessories should be added when the description is
`Class.Humanoid:ApplyDescription()|applied`, usually those attached to its
head resembling hair. The list does not contain duplicates.

An error is thrown if you try to apply a new description which shares any
assets with the existing description but a different accessory property.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.BackAccessory|BackAccessory`,
  `Class.HumanoidDescription.FaceAccessory|FaceAccessory`,
  `Class.HumanoidDescription.FrontAccessory|FrontAccessory`,
  `Class.HumanoidDescription.HatAccessory|HatAccessory`,
  `Class.HumanoidDescription.NeckAccessory|NeckAccessory`,
  `Class.HumanoidDescription.ShouldersAccessory|ShouldersAccessory` and
  `Class.HumanoidDescription.WaistAccessory|WaistAccessory`, which are
  similar properties that apply accessories like this one


HumanoidDescription.HairAccessory

A comma-separated list of asset IDs that will be added as
`Class.Accessory|Accessories` to a `Class.Humanoid` rig when
`Class.Humanoid:ApplyDescription()|applied`, usually those attached to its
head resembling hair.


**HatAccessory** is a comma-separated list of asset IDs that determine
what accessories should be added when the description is
`Class.Humanoid:ApplyDescription()|applied`, usually those attached to its
head. The list does not contain duplicates.

An error is thrown if you try to apply a new description which shares any
assets with the existing description but a different accessory property.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.BackAccessory|BackAccessory`,
  `Class.HumanoidDescription.FaceAccessory|FaceAccessory`,
  `Class.HumanoidDescription.FrontAccessory|FrontAccessory`,
  `Class.HumanoidDescription.HairAccessory|HairAccessory`,
  `Class.HumanoidDescription.NeckAccessory|NeckAccessory`,
  `Class.HumanoidDescription.ShouldersAccessory|ShouldersAccessory` and
  `Class.HumanoidDescription.WaistAccessory|WaistAccessory`, which are
  similar properties that apply accessories like this one


HumanoidDescription.HatAccessory

A comma-separated list of asset IDs that will be added as
`Class.Accessory|Accessories` to a `Class.Humanoid` rig when
`Class.Humanoid:ApplyDescription()|applied`, usually those attached to its
head.


**Head** determines the asset ID of the Head to be
`Class.Humanoid:ApplyDescription()|applied` to a `Class.Humanoid`.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.Torso|Torso`,
  `Class.HumanoidDescription.RightArm|RightArm`,
  `Class.HumanoidDescription.LeftArm|LeftArm`,
  `Class.HumanoidDescription.RightLeg|RightLeg` and
  `Class.HumanoidDescription.LeftLeg|LeftLeg`, which are similar
  properties that also control body part
- `Class.HumanoidDescription.HeadColor|HeadColor`, which controls the
  color of this limb
- `Class.HumanoidDescription.HatAccessory|HatAccessory`,
  `Class.HumanoidDescription.HairAccessory|HairAccessory` and
  `Class.HumanoidDescription.FaceAccessory|FaceAccessory`, which all can
  apply `Class.Accessory` objects which are joined to the head


HumanoidDescription.Head

Determines the asset ID of the Head to be applied to the `Class.Humanoid`.


**HeadColor** determines the `Class.BodyColors.HeadColor3` and
`Class.BodyColors.HeadColor` of a `Class.Humanoid` when the description is
`Class.Humanoid:ApplyDescription()|applied`.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.TorsoColor|TorsoColor`,
  `Class.HumanoidDescription.LeftArmColor|LeftArmColor`,
  `Class.HumanoidDescription.RightArmColor|RightArmColor`,
  `Class.HumanoidDescription.LeftLegColor|LeftLegColor`, and
  `Class.HumanoidDescription.RightLegColor|RightLegColor`, which are
  similar properties that also control body colors
- `Class.HumanoidDescription.Head|Head`, which controls the mesh used for
  the head
- `Class.HumanoidDescription.Face|Face`, which applies a texture to the
  front of the head


HumanoidDescription.HeadColor

Determines the `Class.BodyColors.HeadColor3` and
`Class.BodyColors.HeadColor` of a `Class.Humanoid` when
`Class.Humanoid:ApplyDescription()|applied`.


**HeadScale** determines by what factor the **Head** object of a
`Class.Humanoid` is scaled, as well as any accessories attached to it
(such as those specified by
`Class.HumanoidDescription.HatAccessory|HatAccessory` and
`Class.HumanoidDescription.HairAccessory|HairAccessory`). When the
description is applied through `Class.Humanoid:ApplyDescription()`, this
value maps to a **HeadScale** `Class.NumberValue` within the
`Class.Humanoid`.

#### See Also

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.BodyTypeScale|BodyTypeScale` and
  `Class.HumanoidDescription.ProportionScale|ProportionScale`, which can
  provide realistic rig proportions
- `Class.HumanoidDescription.HeightScale|WidthScale`,
  `Class.HumanoidDescription.DepthScale|HeightScale` and
  `Class.HumanoidDescription.DepthScale|DepthScale`, which provide finer
  control over other dimensions of a rig


HumanoidDescription.HeadScale

Determines by what factor the **Head** object of a `Class.Humanoid` is
scaled, as well as any accessories attached to it.


**HeightScale** determines by what factor the height (top-to-bottom
distance) of a `Class.Humanoid` is scaled, as well as all accessories not
attached to its head. When the description is applied through
`Class.Humanoid:ApplyDescription()`, this value maps to a
**BodyHeightScale** `Class.NumberValue` within the `Class.Humanoid`.

#### See Also

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.BodyTypeScale|BodyTypeScale` and
  `Class.HumanoidDescription.ProportionScale|ProportionScale`, which can
  provide more realistic rig proportions
- `Class.HumanoidDescription.HeightScale|WidthScale` and
  `Class.HumanoidDescription.DepthScale|DepthScale`


HumanoidDescription.HeightScale

Determines by what factor the height (top-to-bottom distance) of a
`Class.Humanoid` is scaled, as well as all accessories not attached to its
head.


When this description is `Class.Humanoid:ApplyDescription()|applied` to a
`Class.Humanoid`, **IdleAnimation** determines the
`Class.Animation.AnimationId` to play when its
`Class.Humanoid:GetState()|state` is `Enum.HumanoidStateType|Running` at a
speed near zero.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.FallAnimation|ClimbAnimation`,
  `Class.HumanoidDescription.FallAnimation|FallAnimation`,
  `Class.HumanoidDescription.JumpAnimation|JumpAnimation`,
  `Class.HumanoidDescription.RunAnimation|RunAnimation`,
  `Class.HumanoidDescription.SwimAnimation|SwimAnimation` and
  `Class.HumanoidDescription.WalkAnimation|WalkAnimation`, which are
  similar properties that determine animations to play on the rig


HumanoidDescription.IdleAnimation

When this description is `Class.Humanoid:ApplyDescription()|applied` to a
`Class.Humanoid`, this determines the `Class.Animation.AnimationId` to
play when its `Class.Humanoid:GetState()|state` is
`Enum.HumanoidStateType|Running` at a speed near zero.


When this description is `Class.Humanoid:ApplyDescription()|applied` to a
`Class.Humanoid`, **JumpAnimation** determines the
`Class.Animation.AnimationId` to play when its
`Class.Humanoid:GetState()|state` is `Enum.HumanoidStateType|Jumping`.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.FallAnimation|ClimbAnimation`,
  `Class.HumanoidDescription.FallAnimation|FallAnimation`,
  `Class.HumanoidDescription.IdleAnimation|IdleAnimation`,
  `Class.HumanoidDescription.RunAnimation|RunAnimation`,
  `Class.HumanoidDescription.SwimAnimation|SwimAnimation` and
  `Class.HumanoidDescription.WalkAnimation|WalkAnimation`, which are
  similar properties that determine animations to play on the rig


HumanoidDescription.JumpAnimation

When this description is `Class.Humanoid:ApplyDescription()|applied` to a
`Class.Humanoid`, this determines the `Class.Animation.AnimationId` to
play when its `Class.Humanoid:GetState()|state` is
`Enum.HumanoidStateType|Jumping`.


**LeftArm** determines the asset ID of the LeftArm to be
`Class.Humanoid:ApplyDescription()|applied` to a `Class.Humanoid`.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.Head|Head`,
  `Class.HumanoidDescription.Torso|Torso`,
  `Class.HumanoidDescription.RightArm|RightArm`,
  `Class.HumanoidDescription.RightLeg|RightLeg` and
  `Class.HumanoidDescription.LeftLeg|LeftLeg`, which are similar
  properties that also control body part
- `Class.HumanoidDescription.LeftArmColor|LeftArmColor`, which controls
  the color of this limb


HumanoidDescription.LeftArm

Determines the asset ID of the LeftArm to be applied to the
`Class.Humanoid`.


**LeftArmColor** determines the `Class.BodyColors.LeftArmColor3` and
`Class.BodyColors.LeftArmColor` of a `Class.Humanoid` when the description
is `Class.Humanoid:ApplyDescription()|applied`. For R15 and Rthro rigs,
this property controls both the upper, lower, and hand parts of the left
arm.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.HeadColor|HeadColor`,
  `Class.HumanoidDescription.TorsoColor|TorsoColor`,
  `Class.HumanoidDescription.RightArmColor|RightArmColor`,
  `Class.HumanoidDescription.LeftLegColor|LeftLegColor`, and
  `Class.HumanoidDescription.RightLegColor|RightLegColor`, which are
  similar properties that also control body colors
- `Class.HumanoidDescription.LeftArm|LeftArm`, which controls the mesh
  used for this limb
- `Class.HumanoidDescription.Shirt|Shirt`, which can apply a texture to
  this limb


HumanoidDescription.LeftArmColor

Determines the `Class.BodyColors.LeftArmColor3` and
`Class.BodyColors.LeftArmColor` of a `Class.Humanoid` when applied.


**LeftLeg** determines the asset ID of the LeftLeg to be
`Class.Humanoid:ApplyDescription()|applied` to a `Class.Humanoid`.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.Head|Head`,
  `Class.HumanoidDescription.Torso|Torso`,
  `Class.HumanoidDescription.RightArm|RightArm`,
  `Class.HumanoidDescription.LeftArm|LeftArm`, and
  `Class.HumanoidDescription.RightLeg|RightLeg`, which are similar
  properties that also control body part
- `Class.HumanoidDescription.LeftLegColor|LeftLegColor`, which controls
  the color of this limb


HumanoidDescription.LeftLeg

Determines the asset ID of the LeftLeg to be applied to the
`Class.Humanoid`.


**LeftLegColor** determines the `Class.BodyColors.LeftLegColor3` and
`Class.BodyColors.LeftLegColor` of a `Class.Humanoid` when the description
is `Class.Humanoid:ApplyDescription()|applied`. For R15 and Rthro rigs,
this property controls both the upper, lower, and foot parts of the left
leg.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.HeadColor|HeadColor`,
  `Class.HumanoidDescription.TorsoColor|TorsoColor`,
  `Class.HumanoidDescription.LeftArmColor|LeftArmColor`,
  `Class.HumanoidDescription.RightArmColor|RightArmColor`, and
  `Class.HumanoidDescription.RightLegColor|RightLegColor`, which are
  similar properties that also control body colors
- `Class.HumanoidDescription.LeftLeg|LeftLeg`, which controls the mesh
  used for this limb
- `Class.HumanoidDescription.Pants|Pants`, which can apply a texture to
  this limb


HumanoidDescription.LeftLegColor

Determines the `Class.BodyColors.LeftLegColor3` and
`Class.BodyColors.LeftLegColor` of a `Class.Humanoid` when applied.


HumanoidDescription.MoodAnimation

**NeckAccessory** is a comma-separated list of asset IDs that determine
what accessories should be added when the description is
`Class.Humanoid:ApplyDescription()|applied`, usually those attached to its
neck (such as scarves or necklaces). The list does not contain duplicates.

Any accessory can used in this property, even if it is meant to go in a
different accessory spot. For example, an accessory meant to go on your
back (such as a cape) could be included in
`Class.HumanoidDescription.HairAccessory|HairAccessory`. An error is
thrown if you try to apply a new description which shares any assets with
the existing description but a different accessory property.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.BackAccessory|BackAccessory`,
  `Class.HumanoidDescription.FaceAccessory|FaceAccessory`,
  `Class.HumanoidDescription.FrontAccessory|FrontAccessory`,
  `Class.HumanoidDescription.HairAccessory|HairAccessory`,
  `Class.HumanoidDescription.HatAccessory|HatAccessory`,
  `Class.HumanoidDescription.ShouldersAccessory|ShouldersAccessory` and
  `Class.HumanoidDescription.WaistAccessory|WaistAccessory`, which are
  similar properties that apply accessories like this one


HumanoidDescription.NeckAccessory

A comma-separated list of asset IDs that will be added as
`Class.Accessory|Accessories` to a `Class.Humanoid` rig when
`Class.Humanoid:ApplyDescription()|applied`, usually those attached to its
neck (such as scarves or necklaces).


**Pants** determines the `Class.Pants.PantsTemplate|PantsTemplate` used by
a `Class.Pants` instance when `Class.Humanoid:ApplyDescription()` is
called on a `Class.Humanoid`. The asset type must be for **Pants**, not a
**Decal** or **Image**.

#### See Also

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.Shirt|Shirt`, a similar property which
  applies to a `Class.Shirt` object
- `Class.HumanoidDescription.TorsoColor|TorsoColor`,
  `Class.HumanoidDescription.LeftLegColor|LeftLegColor` and
  `Class.HumanoidDescription.RightLegColor|RightLegColor`, which can
  change the color of the body parts underneath the pants texture


HumanoidDescription.Pants

Determines the `Class.Pants.PantsTemplate|PantsTemplate` used by a
`Class.Pants` instance.


**ProportionScale** determines how wide (0) or narrow (1) a
`Class.Humanoid` rig is. Values outside the range of 0 to 1 are clamped.
When the description is applied through
`Class.Humanoid:ApplyDescription()`, this value maps to a
**BodyProportionScale** `Class.NumberValue` within the `Class.Humanoid`.

Note that when the value of
`Class.HumanoidDescription.BodyTypeScale|BodyTypeScale` is 0, this
property has no effect.

#### See Also

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.BodyTypeScale|BodyTypeScale`, which also
  affects rig proportions
- `Class.HumanoidDescription.HeightScale|WidthScale`,
  `Class.HumanoidDescription.DepthScale|HeightScale` and
  `Class.HumanoidDescription.DepthScale|DepthScale`, which provide finer
  control over the dimensions of a rig
- `Class.HumanoidDescription.HeadScale|HeadScale`, which provides specific
  control over the scale of the rig's head


HumanoidDescription.ProportionScale

Determines how wide (0) or narrow (1) a `Class.Humanoid` rig is.


**RightArm** determines the asset ID of the RightArm to be
`Class.Humanoid:ApplyDescription()|applied` to a `Class.Humanoid`.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.Head|Head`,
  `Class.HumanoidDescription.Torso|Torso`,
  `Class.HumanoidDescription.LeftArm|LeftArm`,
  `Class.HumanoidDescription.RightLeg|RightLeg` and
  `Class.HumanoidDescription.LeftLeg|LeftLeg`, which are similar
  properties that also control body part
- `Class.HumanoidDescription.RightArmColor|RightArmColor`, which controls
  the color of this limb


HumanoidDescription.RightArm

Determines the asset ID of the RightArm to be applied to the
`Class.Humanoid`.


**RightArmColor** determines the `Class.BodyColors.RightArmColor3` and
`Class.BodyColors.RightArmColor` of a `Class.Humanoid` when the
description is `Class.Humanoid:ApplyDescription()|applied`. For R15 and
Rthro rigs, this property controls both the upper, lower, and hand parts
of the right arm.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.HeadColor|HeadColor`,
  `Class.HumanoidDescription.TorsoColor|TorsoColor`,
  `Class.HumanoidDescription.LeftArmColor|LeftArmColor`,
  `Class.HumanoidDescription.LeftLegColor|LeftLegColor`, and
  `Class.HumanoidDescription.RightLegColor|RightLegColor`, which are
  similar properties that also control body colors
- `Class.HumanoidDescription.RightArm|RightArm`, which controls the mesh
  used for this limb
- `Class.HumanoidDescription.Shirt|Shirt`, which can apply a texture to
  this limb


HumanoidDescription.RightArmColor

Determines the `Class.BodyColors.RightArmColor3` and
`Class.BodyColors.RightArmColor` of a Humanoid when applied.


**RightLeg** determines the asset ID of the RightLeg to be
`Class.Humanoid:ApplyDescription()|applied` to a `Class.Humanoid`.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.Head|Head`,
  `Class.HumanoidDescription.Torso|Torso`,
  `Class.HumanoidDescription.RightArm|RightArm`,
  `Class.HumanoidDescription.LeftArm|LeftArm` and
  `Class.HumanoidDescription.LeftLeg|LeftLeg`, which are similar
  properties that also control body part
- `Class.HumanoidDescription.RightLegColor|RightLegColor`, which controls
  the color of this limb


HumanoidDescription.RightLeg

Determines the asset ID of the RightLeg to be applied to the
`Class.Humanoid`.


**RightLegColor** determines the `Class.BodyColors.RightLegColor3` and
`Class.BodyColors.RightLegColor` of a `Class.Humanoid` when the
description is `Class.Humanoid:ApplyDescription()|applied`. For R15 and
Rthro rigs, this property controls both the upper, lower, and foot parts
of the right leg.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.HeadColor|HeadColor`,
  `Class.HumanoidDescription.TorsoColor|TorsoColor`,
  `Class.HumanoidDescription.LeftArmColor|LeftArmColor`,
  `Class.HumanoidDescription.RightArmColor|RightArmColor`, and
  `Class.HumanoidDescription.LeftLegColor|LeftLegColor`, which are similar
  properties that also control body colors
- `Class.HumanoidDescription.RightLeg|RightLeg`, which controls the mesh
  used for this limb
- `Class.HumanoidDescription.Pants|Pants`, which can apply a texture to
  this limb


HumanoidDescription.RightLegColor

Determines the `Class.BodyColors.RightLegColor3` and
`Class.BodyColors.RightLegColor` of a Humanoid when applied.


When this description is `Class.Humanoid:ApplyDescription()|applied` to a
`Class.Humanoid`, **RunAnimation** determines the
`Class.Animation.AnimationId` to play when its
`Class.Humanoid:GetState()|state` is `Enum.HumanoidStateType|Running` at a
moderate speed.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.FallAnimation|ClimbAnimation`,
  `Class.HumanoidDescription.FallAnimation|FallAnimation`,
  `Class.HumanoidDescription.IdleAnimation|IdleAnimation`,
  `Class.HumanoidDescription.JumpAnimation|JumpAnimation`,
  `Class.HumanoidDescription.SwimAnimation|SwimAnimation` and
  `Class.HumanoidDescription.WalkAnimation|WalkAnimation`, which are
  similar properties that determine animations to play on the rig


HumanoidDescription.RunAnimation

When this description is `Class.Humanoid:ApplyDescription()|applied` to a
`Class.Humanoid`, this determines the `Class.Animation.AnimationId` to
play when its `Class.Humanoid:GetState()|state` is
`Enum.HumanoidStateType|Running` at a moderate speed.


**Shirt** determines the `Class.Shirt.ShirtTemplate|ShirtTemplate` used by
a `Class.Shirt` instance when `Class.Humanoid:ApplyDescription()` is
called on a `Class.Humanoid`. The asset type must be for **Shirt**, not a
**Decal** or **Image**.

#### See Also

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.Pants|Pants`, a similar property which
  applies to a `Class.Pants` object
- `Class.HumanoidDescription.GraphicTShirt|GraphicTShirt`, a similar
  property which applies to a `Class.ShirtGraphic` object
- `Class.HumanoidDescription.TorsoColor|TorsoColor`,
  `Class.HumanoidDescription.LeftArmColor|LeftArmColor` and
  `Class.HumanoidDescription.RightArmColor|RightArmColor`, which can
  change the color of the body parts underneath the shirt texture


HumanoidDescription.Shirt

Determines the `Class.Shirt.ShirtTemplate|ShirtTemplate` used by a
`Class.Shirt` instance.


**ShouldersAccessory** is a comma-separated list of asset IDs that
determine what accessories should be added when the description is
`Class.Humanoid:ApplyDescription()|applied`, usually those attached to its
shoulders (such as shoulder-mounted critters). The list does not contain
duplicates.

An error is thrown if you try to apply a new description which shares any
assets with the existing description but a different accessory property.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.BackAccessory|BackAccessory`,
  `Class.HumanoidDescription.FaceAccessory|FaceAccessory`,
  `Class.HumanoidDescription.FrontAccessory|FrontAccessory`,
  `Class.HumanoidDescription.HairAccessory|HairAccessory`,
  `Class.HumanoidDescription.HatAccessory|HatAccessory`,
  `Class.HumanoidDescription.NeckAccessory|NeckAccessory` and
  `Class.HumanoidDescription.WaistAccessory|WaistAccessory`, which are
  similar properties that apply accessories like this one


HumanoidDescription.ShouldersAccessory

A comma-separated list of asset IDs that will be added as
`Class.Accessory|Accessories` to a `Class.Humanoid` rig when
`Class.Humanoid:ApplyDescription()|applied`, usually those attached to its
shoulders (such as shoulder-mounted critters).


When this description is `Class.Humanoid:ApplyDescription()|applied` to a
`Class.Humanoid`, **SwimAnimation** determines the
`Class.Animation.AnimationId` to play when its
`Class.Humanoid:GetState()|state` is `Enum.HumanoidStateType|Swimming`

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.FallAnimation|ClimbAnimation`,
  `Class.HumanoidDescription.FallAnimation|FallAnimation`,
  `Class.HumanoidDescription.IdleAnimation|IdleAnimation`,
  `Class.HumanoidDescription.JumpAnimation|JumpAnimation`,
  `Class.HumanoidDescription.RunAnimation|RunAnimation` and
  `Class.HumanoidDescription.WalkAnimation|WalkAnimation`, which are
  similar properties that determine animations to play on the rig


HumanoidDescription.SwimAnimation

When this description is `Class.Humanoid:ApplyDescription()|applied` to a
`Class.Humanoid`, this determines the `Class.Animation.AnimationId` to
play when its `Class.Humanoid:GetState()|state` is
`Enum.HumanoidStateType|Swimming`.


**Torso** determines the asset ID of the Torso to be
`Class.Humanoid:ApplyDescription()|applied` to a `Class.Humanoid`.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.Head|Head`,
  `Class.HumanoidDescription.RightArm|RightArm`,
  `Class.HumanoidDescription.LeftArm|LeftArm`,
  `Class.HumanoidDescription.RightLeg|RightLeg` and
  `Class.HumanoidDescription.LeftLeg|LeftLeg`, which are similar
  properties that also control body part
- `Class.HumanoidDescription.TorsoColor|TorsoColor`, which controls the
  color of this limb


HumanoidDescription.Torso

Determines the asset ID of the Torso to be applied to the
`Class.Humanoid`.


**TorsoColor** determines the `Class.BodyColors.TorsoColor3` and
`Class.BodyColors.TorsoColor` of a `Class.Humanoid` when the description
is `Class.Humanoid:ApplyDescription()|applied`. For R15 and Rthro rigs,
this property controls both the upper and lower parts of the torso.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.HeadColor|HeadColor`,
  `Class.HumanoidDescription.TorsoColor|TorsoColor`,
  `Class.HumanoidDescription.LeftArmColor|LeftArmColor`,
  `Class.HumanoidDescription.RightArmColor|RightArmColor`,
  `Class.HumanoidDescription.LeftLegColor|LeftLegColor`, and
  `Class.HumanoidDescription.RightLegColor|RightLegColor`, which are
  similar properties that also control body colors
- `Class.HumanoidDescription.Torso|Torso`, which controls the mesh used
  for this body part
- `Class.HumanoidDescription.GraphicTShirt|GraphicTShirt` and
  `Class.HumanoidDescription.Shirt|Shirt`, which can apply a texture to
  this body part


HumanoidDescription.TorsoColor

Determines the `Class.BodyColors.TorsoColor3` and
`Class.BodyColors.TorsoColor` of a Humanoid when applied.


**WaistAccessory** is a comma-separated list of asset IDs that determine
what accessories should be added when the description is
`Class.Humanoid:ApplyDescription()|applied`, usually those attached to its
waist (such as belts). The list does not contain duplicates.

An error is thrown if you try to apply a new description which shares any
assets with the existing description but a different accessory property.

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.BackAccessory|BackAccessory`,
  `Class.HumanoidDescription.FaceAccessory|FaceAccessory`,
  `Class.HumanoidDescription.FrontAccessory|FrontAccessory`,
  `Class.HumanoidDescription.HairAccessory|HairAccessory`,
  `Class.HumanoidDescription.HatAccessory|HatAccessory`,
  `Class.HumanoidDescription.NeckAccessory|NeckAccessory` and
  `Class.HumanoidDescription.ShouldersAccessory|ShouldersAccessory`, which
  are similar properties that apply accessories like this one


HumanoidDescription.WaistAccessory

A comma-separated list of asset IDs that will be added as
`Class.Accessory|Accessories` to a `Class.Humanoid` rig when
`Class.Humanoid:ApplyDescription()|applied`, usually those attached to its
waist (such as belts).


When this description is `Class.Humanoid:ApplyDescription()|applied` to a
`Class.Humanoid`, **WalkAnimation** determines the
`Class.Animation.AnimationId` to play when its
`Class.Humanoid:GetState()|state` is `Enum.HumanoidStateType|Running` at a
low speed

See also:

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.FallAnimation|ClimbAnimation`,
  `Class.HumanoidDescription.FallAnimation|FallAnimation`,
  `Class.HumanoidDescription.IdleAnimation|IdleAnimation`,
  `Class.HumanoidDescription.JumpAnimation|JumpAnimation`,
  `Class.HumanoidDescription.RunAnimation|RunAnimation` and
  `Class.HumanoidDescription.SwimAnimation|SwimAnimation`, which are
  similar properties that determine animations to play on the rig


HumanoidDescription.WalkAnimation

When this description is `Class.Humanoid:ApplyDescription()|applied` to a
`Class.Humanoid`, this determines the `Class.Animation.AnimationId` to
play when its `Class.Humanoid:GetState()|state` is
`Enum.HumanoidStateType|Running` at a low speed.


**WidthScale** determines by what factor the width (left-to-right
distance) of a `Class.Humanoid` is scaled, as well as all accessories not
attached to its head. When the description is applied through
`Class.Humanoid:ApplyDescription()`, this value maps to a
**BodyWidthScale** `Class.NumberValue` within the `Class.Humanoid`.

#### See Also

- [HumanoidDescription System](/characters/appearance#humanoiddescription),
  for more information on `Class.HumanoidDescription`.
- `Class.HumanoidDescription.BodyTypeScale|BodyTypeScale` and
  `Class.HumanoidDescription.ProportionScale|ProportionScale`, which can
  provide more realistic rig proportions
- `Class.HumanoidDescription.HeightScale|HeightScale` and
  `Class.HumanoidDescription.DepthScale|DepthScale`


HumanoidDescription.WidthScale

Determines by what factor the width (left-to-right distance) of a
`Class.Humanoid` is scaled, as well as all accessories not attached to its
head.


Describes the appearance of a Humanoid character including body parts,
accessories, colors, scales, animations, and emotes.


`Instance` is the base class for all classes in the Roblox class hierarchy
which can be part of the `Class.DataModel` tree.

It is not possible to directly create root `Instance` objects, but the special
`Datatype.Instance.new()` constructor creates objects via code, taking the
name of the class as a parameter and returning the created object.


Demonstrates detecting changes to an instance's ancestry by connecting to the `Class.Instance.AncestryChanged` event.

The ChangingPart's Parent is set to different values overtime. The parent of the part is the part's ancestor, so the `Class.Instance.AncestryChanged` event will fire whenever it changes.

Fires when the `Class.Instance.Parent` property of the object or one of
its ancestors is changed.

This event includes two parameters: `child` refers to the `Class.Instance`
whose `Class.Instance.Parent` was actually changed, while `parent` refers
to this instance's new `Class.Instance.Parent`.

You can use this event to track the deletion of an instance in Studio,
such as manual deletion in the Explorer or through a plugin. If you need
to detect when an instance is destroyed using `Class.Instance:Destroy()`,
use the `Class.Instance.Destroying` event instead.


Instance.AncestryChanged

child

The `Class.Instance` whose `Class.Instance.Parent` has been changed.


parent

The new `Class.Instance.Parent` of the `Class.Instance` whose
`Class.Instance.Parent` was changed.


Fires when the `Class.Instance.Parent` property of the object or one of
its ancestors is changed.


This event fires whenever any attribute is changed on the instance,
including when an attribute is set to `nil`. The name of the changed
attribute is passed to the connected function.

For example, the following code snippet connects the `attributeChanged()`
function to fire whenever one of the part's attributes changes:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "changed")
end

part.AttributeChanged:Connect(attributeChanged)
```

See also `Class.Instance:GetAttributeChangedSignal()` which returns an
event that fires when a specific given attribute changes.


Instance.AttributeChanged

attribute

The name of the attribute that has been changed.


Fires whenever an attribute is changed on the `Class.Instance`.


This snippet prints the names of objects as they are added to the Workspace:

Fires after an object is parented to this `Class.Instance`.

Note, when using this method on a client to detect objects created by the
server it is necessary to use `Class.Instance:WaitForChild()` when
indexing these object's descendants. This is because the object and its
descendants are not guaranteed to replicate from the server to the client
simultaneously. For example:

```
local Workspace = game:GetService("Workspace")

Workspace.ChildAdded:Connect(function(child)
	-- Use WaitForChild() since descendants may not have replicated yet
	local head = child:WaitForChild("Head")
end)
```

Note, this event only operates for immediate children of the
`Class.Instance`. For an event that captures all descendants, use
`Class.Instance.DescendantAdded`.

See also `Class.Instance.ChildRemoved`.


Instance.ChildAdded

The `Class.Instance` that has been added.


Fires after an object is parented to this `Class.Instance`.


Instance.childAdded

This snippet prints the names of objects as they are removed from the
Workspace:

Fires after a child is removed from this `Class.Instance`.

Removed refers to when an object's parent is changed from this
`Class.Instance` to something other than this `Class.Instance`. Note, this
event will also fire when a child is destroyed (using
`Class.Instance:Destroy()`) as the destroy function sets an object's
parent to `nil`.

This event only operates for immediate children of the `Class.Instance`.
For an event that captures all descendants, use
`Class.Instance.DescendantRemoving`.

See also `Class.Instance.ChildAdded`.


Instance.ChildRemoved

The `Class.Instance` that has been removed.


Fires after a child is removed from this `Class.Instance`.


This following example will print the name of any object that is added to the
Workspace:

This event fires after a descendant is added to the `Class.Instance`.

As it fires for every descendant, parenting an object to the
`Class.Instance` will fire the event for this object and all of its
descendants individually.

If you're only concerned with the **direct children** of the
`Class.Instance`, use `Class.Instance.ChildAdded` instead.

See also `Class.Instance.DescendantRemoving`.


Instance.DescendantAdded

descendant

Fires after a descendant is added to the `Class.Instance`.


The following example prints the name of any descendant as it is being removed
from the Workspace:

This event fires **immediately before** the parent `Class.Instance`
changes such that a **descendant** instance will no longer be a
descendant. `Class.Instance:Destroy()|Destroy()` changes an instance's
`Class.Instance.Parent|Parent` to `nil`, so calling that method on a
descendant of the parent will cause this event to fire.

Since this event fires **before** the descendant's removal, the parent of
the descendant will be unchanged at the time of this event firing. If the
descendant is also a **direct child** of the parent, this event will fire
before `Class.Instance.ChildRemoved`.

If a descendant has children, this event fires with the descendant first,
followed by its descendants.

##### Warning

This event fires with the descendant object that is being removed.
Attempting to set the `Class.Instance.Parent|Parent` of the descendant to
something else will fail. Below is an example that demonstrates this:

```
local Workspace = game:GetService("Workspace")

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Do not manipulate the parent of the descendant in this function!
	-- This event fires BECAUSE the parent was manipulated, and the change hasn't happened yet
	-- Therefore, it is problematic to change the parent like this:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```

See also `Class.Instance.DescendantAdded|DescendantAdded`.


Instance.DescendantRemoving

The `Class.Instance` that is being removed.


Fires immediately before a descendant of the `Class.Instance` is removed.


Instance

`Instance` is the base class for all classes in the Roblox class hierarchy
which can be part of the `Class.DataModel` tree.


/reference/engine/classes/HumanoidDescription.yaml

HumanoidDescription

Summary

Properties

Methods

Events

Properties

Methods

Events

On this page