Uploading your own avatar (GLB or Spine)
What the file must contain and the steps to add your own 3D (GLB) or 2D (Spine) avatar.
Who can upload?
Adding your own avatar is the Pro plan's “Custom avatar upload” feature; it's also available during the free trial. You need the owner or admin role. If your plan doesn't include it, the Avatars page shows a note pointing to the plans instead of the import buttons.
3D avatar (GLB)
- Press “Import GLB” on the “Avatars” page or on the flow editor's “Avatar” card.
- Choose a single .glb file (up to 20 MB).
- Set the name, voice and background, then save. The voice you choose also sets the avatar's posture (male or female).
The file must contain:
- glTF 2.0 binary (.glb) format.
- A Ready Player Me or Mixamo skeleton (finger bones included).
- 14 Oculus viseme morph targets for lip-sync (such as viseme_PP, viseme_FF, viseme_aa). The morph names must be exported.
If anything is missing, the upload is rejected and the missing bone or viseme names are shown under the file field.
Optionally, add clips named listening (idle), greeting, agree, disagree, happy, sad and pointing to the file; the avatar uses them to move its hands and arms. Without these clips the avatar only plays its idle clip.
2D avatar (Spine)
- Press “Import rig” on the “Avatars” page or on the flow editor's “Avatar” card.
- Under “Rig files”, choose the three files: “Skeleton (.skel)”, “Atlas (.atlas / .txt)” and “Texture (.png)”. Each file can be up to 20 MB.
- Set the name, voice and background, then save.
The files must contain:
- A binary export from Spine.
- A single-page atlas: all parts in one PNG.
- Listening, talking and blinking loops, and mouth poses “1” to “21”.
After uploading
The avatar appears in the library as a card; you can try it with “Speak” and pick it in the flow editor. If you uploaded it from the editor, it comes already selected for that agent.
With “Edit” in the three-dot menu you can change only the name, voice and background; to change the files, upload the avatar again. While copies of an avatar you uploaded exist, the original can't be deleted; delete the copies first. An avatar used in an agent can't be deleted either; first pick another avatar in those agents and publish them.
Related articles
- Avatar library: getting to know, trying and copying avatarsGet to know the ready-made avatars, try them by making them speak, copy them with a background that fits your brand and assign them to your agent.
- Plan, credit usage and billingComparing plans, seeing where credits went, topping up credits, choosing and paying for a plan, changing plans, payment and cancelling.