# Rig Instances

A Rig Instance ties together components (i.e., head and body) which in turn trigger their own RigLogic evaluations per .dna file.

Canonical URL: https://docs.polyhammer.com/blender-addons/character-dna/0.15.1/free-features/rig-instances
Product: character-dna
Version: 0.15.1
Channel: production
Updated: 2026-11-21T13:45:20Z
Documentation source: initial main snapshot approved 2026-11-21T13:45:20Z
Documentation commit: 3533cd1260a9bd4b2806aaa4c64ead70766a1674
Release tag commit: 71125e9857db2b5a8ffa9426cc1f769d13017fd5
Owner-approved migration baseline: use current main documentation for the current stable release once; all subsequent releases use their tag snapshots.

A [Rig Instance](/blender-addons/character-dna/0.15.1/terminology#rig-instance) ties together components (i.e., head and body) which in turn trigger their own RigLogic evaluations per `.dna` file. This panel manages the list of instances in your scene and the data each one links to. The sidebar (and every editor panel in it) is context-sensitive to the **active** instance selected here.

![1](https://docs.polyhammer.com/docs-assets/character-dna/1266b506df4569026b7751ea740d32b5ea2fabb12ae380687e89495ef772c326/images/rig-instances/1.png)

## The Instance List [#the-instance-list]

Each row is one Rig Instance. Per-row toggles control what RigLogic outputs for that instance:

| Toggle        | Output                                                                         |
| ------------- | ------------------------------------------------------------------------------ |
| Auto Evaluate | Master switch — evaluate this instance live                                    |
| Bones         | Bone transforms                                                                |
| Shape Keys    | Shape key values                                                               |
| Texture Masks | Wrinkle map masks on the [Texture Logic](/blender-addons/character-dna/0.15.1/terminology#texture-logic) node |
| RBFs          | Radial Basis Function corrective poses (body)                                  |

Use the side buttons to **Add**, **Remove**, **Duplicate**, and reorder instances.

<Callout type="idea" title="Tip">
Always use **Duplicate** to copy an instance — it re-links all data and constraints. Manually duplicating the objects will leave the new head and body disconnected from their underlying DNA relationships.
</Callout>

## Linked Data [#linked-data]

Expand the **Head** and **Body** sub-panels to assign the objects each RigLogic evaluation reads from. The header checkbox on each enables auto-evaluation for that component.

### Head [#head]

| Field         | Purpose                                                                                  |
| ------------- | ---------------------------------------------------------------------------------------- |
| Head DNA File | The `.dna` file RigLogic reads for the head                                              |
| Face Board    | The armature RigLogic reads [GUI control](/blender-addons/character-dna/0.15.1/terminology#gui-controls) positions from |
| Head Mesh     | The mesh whose shape keys are evaluated                                                  |
| Head Rig      | The armature whose bones are evaluated                                                   |
| Head Material | The material carrying the [Texture Logic](/blender-addons/character-dna/0.15.1/terminology#texture-logic) node          |

### Body [#body]

| Field         | Purpose                                                                                                             |
| ------------- | ------------------------------------------------------------------------------------------------------------------- |
| Body DNA File | The `.dna` file RigLogic reads for the body                                                                         |
| Control Rig   | When this is set, the body rig listens for dependency graph updates from this object, which trigger RigLogic updates|
| Body Mesh     | The body mesh                                                                                                       |
| Body Rig      | The body deform armature                                                                                            |
| Body Material | The body material                                                                                                   |

<Callout type="info" title="Note">
A red/alerted field means required data is missing or a DNA file can't be found on disk. Fields are filled in automatically when you import a DNA file, but you can adjust and re-link data manually. This is important to keep in mind when moving your `.blend` file location, since the `.dna` files are a dependency for the rigs. You can use Blender's relative path syntax to help with this. For example, `//head.dna`, `//body.dna`, etc.
</Callout>

## Head to Body Constraint Influence [#head-to-body-constraint-influence]

When a head and body are imported together, the head is constrained to follow the body's bones. This slider controls how strongly the head follows the body. Setting it to zero detaches it completely from the body.

## Force Evaluate [#force-evaluate]

Forces evaluation for the active [Rig Instance](/blender-addons/character-dna/0.15.1/terminology#rig-instance) and resets its cache. This is the catch-all for refreshing your RigLogic connections and references in case something changed or data is stale.
