# Shape Key Editor

The Shape Key Editor is part of the Pro edition and only appears when Pro is installed.

Canonical URL: https://docs.polyhammer.com/blender-addons/character-dna/0.15.1/pro-features/shape-key-editor
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.

<Callout type="info" title="Pro Feature">
The Shape Key Editor is part of the **Pro** edition and only appears when Pro is installed.
</Callout>

Edit the blend shapes (shape keys) a DNA drives. With this editor, you will sculpt directly onto the activated shape key while locking all others.

<Callout type="info" title="Note">
A basic shape key like `jaw_open` sits on top of a single `jawOpen` Raw Control value and its posed bones. Other shape keys like `MCornerDepress_NSwrinkle_Jopen_R` are only visible as correctives that activate in the face when other raw controls or shape keys are active as well.
Thus, entering editing mode activates the dependents backward from the desired shape key you want to edit.
</Callout>

[Video: shape key editor](https://docs.polyhammer.com/docs-assets/character-dna/1266b506df4569026b7751ea740d32b5ea2fabb12ae380687e89495ef772c326/images/shape-key-editor/shape_key_editor.webm)

## Importing Shape Keys [#importing-shape-keys]

Choose **Head** or **Body** with the shared **Component** selector. Import and editing use that component's DNA. The selector is locked during an import or edit session. A component with no blend-shape targets has no shape keys to import.

If you just imported your MetaHuman, then you need to run the **Import Shape Keys** operator to actually load them from the DNA into the Blender scene. Enable **Generate Neutral** to auto-generate neutral shapes during import if you want to work with a clean slate.

## Choosing a Shape Key [#choosing-a-shape-key]

The list shows every shape key channel. Filter by:

- **Mesh** — scope shape keys to a specific LOD0 mesh.
- **Name** — search a shape key by name.
- **Non-Zero** — hide-zero-value shape keys. (This can be useful to find which shape keys are activated.)
- **Value Sort** — sort by value so you can see which shape keys have the highest values.
- **Side** — a side filter (Left / Right / Center). Helpful if you only want to work on one side of the face.
- **Deltas** — the ghost button is a filter to hide shape keys that do not actually contain vertex changes (a sculpted offset different from the basis). This so you can quickly spot which shape keys hold edits. This is handy when sculpting a custom character where most shape keys have been zeroed out from the beginning.
- **Freeze** — the snowflake button locks the current list order and filtering in place so rows do not reshuffle while you scrub shape key values.

## Editing with Dependencies [#editing-with-dependencies]

Select a channel and click **Edit**. Because expressions combine through [PSDs](/blender-addons/character-dna/0.15.1/terminology#how-an-expression-is-evaluated), a shape key often depends on other shapes and raw controls. The editor shows a **dependency list** so you can see exactly what contributes to the shape you're editing:

- The dependencies are **locked** (read-only context).
- The edited key is **unlocked**.
- Toggle each dependency's visibility to diff what you're sculpting vs what is below it.

You can make changes in **Sculpt** or **Edit** mode, using Mirror / Flip / Reset as needed, then **Commit** to write the change into the DNA or **Revert** to discard it.
