> For the complete documentation index, see [llms.txt](https://motion-studio.mtmograph.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://motion-studio.mtmograph.com/ae-extension/tools/merge-new.md).

# Merge (new!)

Merge Shape Layers, preserving keyframes, expressions, and parents

## Description

Merge selected Shape Layers into a single Shape Layer. Optionally preserve keyframes, expressions, and parent chains.

Each source shape layer becomes a nested group with the same name, stacked in original layer order.&#x20;

Anchor Point, PSR and Opacity all transfer to the group's transform properties. Blend modes also carry over to the groups, however Dissolve and some other modes without group equivalents will default to Normal.

<figure><img src="https://2974066525-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0OafyB2j0nkNsYkvQzdr%2Fuploads%2FsI7i4bQH0uzTOfu4SHgm%2FCleanShot%202026-10-26%20at%2009.24.21%402x.png?alt=media&amp;token=fc777ebc-04f7-4b6a-8506-984634453a84" alt="" width="345"><figcaption></figcaption></figure>

### Migrate Keyframes

On: Merge every shape's keyframes, including their easings, interpolation, spatial tangents, and keyframe labels.

Off: Freeze every property at the current frame

### Migrate Expressions

On: Expressions are migrated, replacing syntax with the source layers' values (i.e. *thisLayer.name*). We try to preserve the expression as best we can, renaming duplicate collisions, etc., but there may be certain cases in which the expressions do not translate exactly.

Off: Each property keeps the value at the current frame

### Keep Parented Layers

On: Each layer's parent chain is rebuilt as nested groups named after each parent. They carry the parent's properties.

Off: The layer is first unparented before merging
