> For the complete documentation index, see [llms.txt](https://help.intangible.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.intangible.ai/build/pose-edit-mode.md). # Pose Edit Mode Pose a character joint by joint, or start from a named pose and adjust from there. A character arrives in a default stance. Getting it to kneel, reach, or sit in a car seat means moving joints, not the whole figure. Pose Edit Mode does that one joint at a time. Pose Edit Mode shipped in release 2.0.67. ![A character in Pose Edit Mode, joints shown as white dots along the rig, with the mode indicator top left and the control legend bottom left](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-0251f6ac9d0c23f8cd762e57883f9b03beba82bf%2Fpose-edit-joints-01.png?alt=media) ## Pose a joint 1. **Select the character** in Build. 2. **Open Pose Edit Mode** from the **Pose** button on the contextual toolbar that appears with the character selected. The indicator at the top left changes to read Pose Edit Mode, and the button's own tooltip changes to Exit pose mode, because it is a toggle: click it again to come back out. 3. **Find the joint.** Joints appear as white dots along the rig: shoulders, elbows, hips, knees, ankles. 4. **Click the joint.** Rotation rings appear around it, one per axis. 5. **Drag a ring.** The limb rotates around that axis. The rest of the figure holds. ![Rotating a joint in Pose Edit Mode](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-eb9e066776107d79f1fd2809f8fe81e96fd71936%2Fpose-edit-rotate-01.gif?alt=media) ## Start from a named pose Building a pose from the default stance is slow. The **Select Pose** library holds presets you can drop onto the character and adjust from there. Poses carry names like Being Carried, Bent Over, and Crouch 01 through Crouch 06. A search field filters the list. ![The Select Pose library, showing named pose thumbnails and a search field](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-8a7a55f7275ef0d50c8a2ade758fd993f3e80465%2Fpose-edit-library-01.png?alt=media) Pick one, then adjust individual joints on top of it. Choosing a pose closes the drawer and puts focus back on the viewport, so undo works on the pose you just applied without clicking into the scene first. Filter chips sit above the thumbnails, or inside the grid when the drawer is narrow. The pose you are currently on is marked in the grid. Inside Pose Edit Mode, the pose toolbar has a **Pose library** button that opens the same drawer. The **Pose library** and **Save Pose** buttons show only for humanoid characters. Other rigs can still be posed joint by joint, and can use [partial poses](#save-and-reuse-part-of-a-pose). ## Save your own pose Once a pose is right, save it so you can drop it onto any humanoid later, or hand it to the rest of your team. 1. **Build the pose** in Pose Edit Mode. Start from a library pose, adjust joints, or both. 2. **Click Save Pose** on the pose toolbar. It is the icon with a plus, next to the **Pose library** button. 3. **Name it** in the **Save Pose** dialog. The dialog renders a thumbnail of the character first, and the button reads Preparing… until it is ready. Names can be up to 100 characters. 4. **Click Save.** A toast confirms **Pose saved to My Poses**. The pose lands in a **My Poses** category in the pose library, with the name and thumbnail you saved. It is saved exactly as it looks, including any joint edits you made on top of a library pose, so applying it later reproduces the same result. ### Who can see saved poses Saved poses belong to the workspace you are working in, not to you alone. * **Team workspace**: everyone on that team sees the pose under My Poses. * **Personal workspace**: the pose is saved to your personal workspace, so only you see it. Poses saved in one workspace do not show up in another. See [Workspaces](/teams-and-billing/workspaces.md). If the dialog says **Select a team to save a pose.**, the editor could not tell which workspace to save to, for example in a project shared with you from a team you are not on. Switch to one of your own workspaces and try again. There is no way to rename or delete a saved pose from the editor yet. ## Save and reuse part of a pose Sometimes the body is fine and only the hand is wrong. Partial poses save and apply one joint and everything below it, and leave the rest of the character alone. Click a joint in Pose Edit Mode. A small bar appears next to it with two buttons: * **A hand or any finger**: **Hand poses** and **Save hand pose**. A hand pose always covers the whole hand, wrist and all fingers, even if you clicked a single finger. * **Any other joint**: **Partial poses** and **Save partial pose**. These cover that joint and every joint below it, such as an arm from the shoulder down. ### Save a hand or partial pose 1. **Pose the hand**, or the limb, the way you want it. 2. **Click Save hand pose** (or **Save partial pose**). 3. **Name it** in the **Save Hand Pose** or **Save Partial Pose** dialog. The thumbnail is framed on the hand rather than the whole character. 4. **Click Save.** A toast confirms **Hand pose saved** or **Partial pose saved**. Hand and partial poses follow the same workspace rules as full poses. ### Apply one 1. **Click the joint** you want to change. 2. **Click Hand poses** (or **Partial poses**). A drawer lists the poses saved for that kind of joint, with a search field. 3. **Pick one.** Only the joints in that chain change. The rest of the character, including the base pose and any other joint edits, stays as it was. One undo reverses it. If nothing has been saved yet, the drawer says **No hand poses yet. Select a hand and use Save hand pose to add one.** ### Left hand, right hand A hand pose saved on one hand works on both. Apply a right-hand pose to the left hand and it is mirrored, so a pointing finger still points, rather than bending the wrong way. The same matching applies to other paired or numbered limbs, as long as the joints follow a common naming pattern, such as Left and Right in the name or .l and .r or \_l and \_r at the end. Matching works by joint name, which suits characters from the library. A rig whose left and right joints are not named that way will not offer the other side's poses. The Hand poses label applies to library (Mixamo-style) characters. On other rigs, the same controls appear as Partial poses. Saved poses, hand poses and partial poses were added in release 2.0.74. ## Move the whole character Posing joints moves limbs. To move the figure itself, select the **root circle** at the base of the rig. With it selected the ordinary gizmo comes back, so you can translate, rotate and scale the whole character, with the same global and local modes and the same snapping you use outside the mode. See [Transform](/build/transform.md). That means you can pose a character and place it without leaving and re-entering. Added in release 2.0.72. ## Moving around while you pose The camera controls differ from the main Build viewport. | Action | Input | | ------------------- | ----- | | Orbit | Mouse | | Pan | Mouse | | Zoom | Mouse | | Frame the character | `F` | **`Esc` exits**, and so does the X in the control bar, and so does clicking the Pose button a second time. The mode's own toolbar labels its exit **Exit pose mode**. ## Hairstyle Pose is not the only thing on that contextual toolbar. **Hairstyle** sits beside it and opens a **Select Hairstyle** drawer: a grid of styles with a **Search hairstyles** field above it, and a **None** card first that clears whatever the character is wearing. ![The Select Hairstyle drawer: a None card carrying a crossed-circle icon, then a grid of hairstyle thumbnails, with a search field across the top](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-086734d223f60845e812e394deb4838f4db4c11e%2Fselect-hairstyle-01.png?alt=media) Picking one applies it and closes the drawer, the same way the pose library behaves. ## Related * [Working with objects](/build/working-with-objects.md) for selection, parenting, and transforms * [Animation](/compose/animation.md) for keyframing a character across a shot --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://help.intangible.ai/build/pose-edit-mode.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.