Skip to content

Create and reuse symbols

Verification record: Umoupen 0.9.59 build 628 (2026-10-05) · Verification scope

A Symbol is an asset for reusing artwork or animation. Each placement on the Stage is called a Symbol instance.

Location: Gallery panel / symbol actions in the Layers panel

When you place the same Symbol several times, its instances reference the same source. They share the artwork or animation, while each placement can have its own position, scale, rotation, Tint, Opacity, and playback settings.

TermMeaning
Symbol sourceThe artwork or animation being reused. Instances referencing the same source share these contents.
Symbol instanceA Symbol placed on the Stage, with its own position, scale, and playback settings.
GalleryAn asset browser for finding the Symbols you created and placing them on the Stage.

For example, turn a character animation into a Symbol and place it twice. You can make one placement smaller or start playback at a different frame. Editing the character artwork in the source updates both placements.

When editing, choose whether to change the appearance of this placement or revise the shared contents. See Symbol instances and Edit in Place for the settings and a comparison of the same animation with different start frames.

Umoupen provides Convert Selection to Symbol and Convert Layer to Symbol. The difference is the scope they convert.

Convert Layer to Symbol appears between Move to New Folder and Duplicate Layer.

Scope to convertTerm used in this guideOn-screen command
Artwork selected on the StageConvert the selection to a SymbolConvert Selection to Symbol
The entire selected layerConvert the layer to a SymbolConvert Layer to Symbol
  1. On the Stage, select the artwork you want to convert.
  2. Right-click and choose Convert Selection to Symbol. You can also press Cmd+G (Ctrl+G on Windows).
  3. Confirm that the selection is now a Symbol instance and that its source appears in the Gallery panel.

The command creates a Symbol from the selected content and replaces the Stage selection with an instance of that Symbol.

  1. In the Layers panel, select the layer you want to convert.
  2. Right-click the layer and choose Convert Layer to Symbol.
  3. Confirm that the entire layer has been converted and that its source appears in the Gallery panel.
  4. Select the converted Symbol and confirm that Move and Scale are available.
  1. At the frame where you want to place it, make a Vector Layer active.
  2. Drag the Symbol from the Gallery to the Stage to place a Symbol instance.

You can move, scale, or tween the placed instance. To revise its contents, use Edit in Place to open the shared source.

SymptomCheck this first
You want to convert only part of the artworkSelect it on the Stage, then choose Convert Selection to Symbol.
You want to convert an entire layerSelect it in the Layers panel, then choose Convert Layer to Symbol.
Nothing is added to the GalleryCheck the Stage selection or the selected layer, then run the corresponding command again.
“Symbols can only be added to vector layers” appearsMake the destination Vector Layer active, then drag the item again.
You cannot find the source of a placed assetRight-click the instance and choose Show in Gallery.
OptionWhat it does
Convert Selection to Symbol / Convert Layer to SymbolCreates a source asset from the selection or the layer.
Drag from the Gallery onto the StagePlaces an existing symbol in the frame.
Import / Export SymbolReads or writes a symbol package.
Set as symbol defaultStores the default state.

Use Import for an external Symbol package and Export Symbol to pass one as a separate file. Compatibility varies by external Symbol format, so check its appearance and playback after importing it.

  • Hands-on verified: Checked and captured the displayed panel or menu in the installed app. Convert Layer to Symbol appears between Move to New Folder and Duplicate Layer. The published image is a faithful crop of the source screenshot.
  • Unverified: Verification covers only the interface shown in the image. All article procedures, effects of setting changes, exported file contents, saving/reopening and the Windows version were not reverified in this capture session.