4 min read

Source: Roblox Creator Hub · CC BY 4.0 · View source · Code samples: MIT Imported 2026-10-03. Formatting adapted for this site.

Dynamic head specifications

Character body models with dynamic heads require a specific set of components and configuration standards so that the entire model works as expected across the platform, including universal support for head accessories and facial animation, and so that the characters can be sold on the Marketplace.

Before you start the export process, verify that your model meets the following modeling specifications and guidelines for proper Studio compatibility.

Note

Validation for dynamic heads uses a specialized process that may require you to adjust your existing dynamic head asset. For more information, see Dynamic head validation.

Note

Avatar Setup automatically generates components for your avatar characters, including the head cage and facial animation required for the Marketplace. You can save time by submitting character models without avatar components into Avatar Setup, then modifying the output. If necessary, you can download your output as a .gltf, then adjust the FACS or cage data in your third-party modeling tool.

For issues or feedback regarding Avatar Setup, submit a bug report.

Outer cage

Like all avatar character body parts, dynamic heads require an outer cage to ensure layered accessories work properly. In addition, dynamic head outer cages serve to establish facial landmarks for the eyes and mouth of the face for the validation process.

For information on how to improve or resolve errors with your dynamic head's outer cage, see Dynamic head caging best practices.

Facial landmarks

During validation, Roblox projects the cage eye/mouth regions to the base mesh to identify the eyes and mouth regions of your character head. Roblox expects the following 3 distinct landmarks in your cages:

• Left eye landmark
• Right eye landmark
• Mouth landmark

Even for non-humanoid faces that don't include visual eyes or mouths, it's important to ensure that these landmarks still exist and can be projected over your base mesh. For more information on this process, see Dynamic head validation.

Note

The mouth landmark vertices are on the second loop of vertices from the mouth opening. This precision can help prevent issues with landmark validation.

FACS poses

Dynamic heads support facial animation and can include many different base poses to meet the needs of your character design. That being said, avatar character bodies require at least the following 17 FACS poses to support avatar chat:

• LeftEyeClosed
• RightEyeClosed
• EyesLookDown
• JawDrop
• Pucker
• LeftLipCornerPuller
• RightLipCornerPuller
• ChinRaiser
• ChinRaiserUpperLip
• LeftCheekRaiser
• RightCheekRaiser
• LeftInnerBrowRaiser
• RightInnerBrowRaiser
• LeftLipCornerDown
• RightLipCornerDown
• LeftLowerLipDepressor
• RightLowerLipDepressor

Note

While these 17 poses are a requirement, it's recommended to include as many facial poses as possible in your asset to improve expressiveness and facial animation fidelity for facial animations.

To pass the dynamic head validation process, your character's head must successfully perform the following 5 facial actions. If the dynamic head can't deform at the points of the cage's facial landmarks for these actions, validation fails for the asset.

Marketplace requirements

Along with the other technical requirements listed, your character bodies with dynamic heads must meet the following additional specifications before uploading them to the Marketplace to sell:

• Ensure that your character bodies adhere to Marketplace policies.
• Whenever applicable, ensure that your character bodies adhere to Roblox's custom mesh specifications and character body specifications.
• Object Material is set to Plastic.
• Object Transparency is set to 0.
• Object VertexColor is the default 1, 1, 1.
• If your character's head includes separate eyelash and eyebrow assets, you must add them to your character body model as Accessory objects. For more information, see Publish bodies with eyelashes and eyebrows.
• Your Model instance doesn't contain extraneous objects, like Script or additional Part instances.