Layers and Groups¶
A decal is a stack of layers. The Layers & Groups section of the editing panel lists them, lets you reorder, hide, lock and group them, and decides how each layer combines with the ones below.
The layer list¶
The top row of the list is the top of the stack. It is evaluated last and sits above the rows below it.

Each row shows, from left to right:
| Element | What it does |
|---|---|
| Folder arrow (groups) | Expands or collapses the group |
| Checkbox | Selects the layer for group, align and boolean actions |
| Shows or hides the layer | |
| Protects the layer: it can no longer be picked or edited in the viewport, but stays selectable in the list so you can unlock it | |
| Solo: isolates the layer in the preview only | |
| Name | Double-click to rename |
| Operation symbol | + Add, − Cut, and the cover symbols |
| The layer or group is a linked instance |
The buttons on the right of the list:
| Button | Action |
|---|---|
| Up / Down arrows | Move the active layer in the stack |
| Duplicate | Copy the selected layers and groups (Ctrl+D) |
| Group the selected layers (Ctrl+G) | |
| Add to Group menu | Move the active layer into an existing group |
| Move the active layer out of its group | |
| X | Delete the selected layers and groups |
| Shown while you are working inside a group |
Drag to reorder
Drag a row to move it: it takes the place of the row it lands on, inside that row's group. Drop it on a group header to join that group (or to leave it if it is already a member). Hold Shift while dropping a group to put it inside the group under the cursor. Dropping outside the sidebar takes the layer out of its group without moving it.
Selecting layers¶
- Click a row or a shape in the viewport to select it.
- Shift + click adds to the selection. The checkboxes do the same.
- Click empty space to deselect. Alt + click cycles through overlapping shapes.
- Ctrl + click is left to Blender (rename) and to snapping.
Solo is a preview tool
Solo does not change the stored visibility and never affects an export. Click the star again, or press Exit Solo (preview only) under the list, to see everything.
How a layer combines with the layers below¶
At the top of the Active Shape section, the Operation rows decide how the layer meets the shapes beneath it.
| Operation | Effect |
|---|---|
| Add | Raises the layer on top of the shapes below, which stay visible |
| Cut | Digs into the shapes below, which stay visible. It can go below the zero plane |
| Cover + | Hides the shapes below and raises this layer from the base |
| Cover - | Hides the shapes below and sinks this layer from the base |
| Cover On Top | Hides the shapes below and raises this layer from the highest point beneath it |
| Cover Into Top | Hides the shapes below and sinks this layer from the highest point beneath it |
On the shape itself, the Add / Cut button cycles the operation when you click it, and Shift + click opens the full chooser. See Selecting and Transforming.
Blend¶
In Shape Parameters > Relief, Blend fuses the layer with the one just below it, like a smooth union. Overlaps merge instead of adding up. It is available for Add and Cut on most shapes.
Clip to Below¶
In Shape Parameters > Mask, Clip to Below shows a layer only inside the layer directly below it in the list.
- Consecutive clipped layers share the same base.
- Masks are skipped.
- A hidden base hides the clipped layers too.
Use As: Relief, Color, Relief + Color, Mask¶
The Use As row decides what the layer produces. See Create Decal and the Canvas for the first three.
A layer set to Mask is not drawn. It cuts the rows below it, or keeps only its own area, depending on Mask Effect:
| Mask Effect | Result |
|---|---|
| Cut | Removes the mask area from every row below it, inside its group if it has one |
| Keep | Keeps only the mask area on every row below it |
| Picked Only | Acts only on layers that choose this mask in their own Mask box |
| Target Only | Affects exactly one layer or group, chosen in Target, whatever the stack order. Cut or Keep sets its effect |
Cut Bevel softens the edge of the cut. Hiding a mask turns its effect off.
A normal shape that also masks
Tick Also Mask on a regular layer to keep it drawn and let it mask other layers with the same settings.
Boolean and alignment tools¶
Select two or more layers with Shift + click. A Selected Shapes box appears under the list.
| Tool | Needs | Effect |
|---|---|---|
| Union, Cut, Intersect, Smooth Union | Exactly two layers | The active layer keeps its relief and color. The other becomes an editable mask, and both stay in the list |
| Left / Center X / Right, Bottom / Center Y / Top | Two or more | Aligns the layers to the active one |
| Move to Active | Two or more | Centers the layers on the active one |
| Equal Gaps X / Y | Three or more | Spreads the layers evenly, keeping the two outer ones fixed |
For Smooth Union, Blend Width rounds the junction. To remove a boolean, set the result's mask mode to Off, or turn off Use Only as Mask on the operand to draw it normally again.
Groups¶
A group moves, scales, hides and locks several layers as one.
How to make a group¶
- Select the layers (checkboxes or Shift + click).
- Click Group or press Ctrl+G.
The selected layers must share the same parent and must not be locked.
Working with a group¶
- Click a group row, or any member in the viewport, to select the whole group.
- Drag the group or press G to move it. The corner handles, S and the Width / Height fields resize every member uniformly around their shared center. Spacing, bevels, corner radii and relief scale with it.
- Select a member row to edit it alone. While a group is the editing context, the list shows only its layers and new shapes join it. Press Exit Group, or Esc when nothing is in progress, to go back.
- Hiding a group hides its members without touching their own visibility flags.
- Ungroup (in the Active Group section) removes the group and keeps every layer, position and relief. Turn off group modifiers and group bevel first.
The Active Group section has its own Group Parameters (position, size, rotation, group bevel with profile and edge softness, member offset and contour), a Shading tab and a Modifiers tab. See Modifiers and Materials and Finishes.
Keep beveled groups together
Members of a group with a bevel must stay next to each other in the stack. Do not interleave unrelated layers between them.
Nested groups¶
A group can contain other groups. Select groups and layers that share a parent and click Group again. Parent effects, visibility and locks apply to every descendant, and ungrouping a parent keeps its child groups. Nested group effects apply from the inside out.
Duplicates and instances¶
| Command | Key | Result |
|---|---|---|
| Duplicate | Ctrl+D or the button | An independent copy of the selected layers and groups, nested groups included |
| Duplicate and move | Shift+D | Copies, then starts moving the copy. Esc cancels the move |
| Duplicate as instance | Alt+D | A linked copy, then starts moving it |
Linked copies form a family. Shape, material, path and modifier edits apply to every member of the family, while position, rotation and size stay independent. This works for groups and nested groups too, and each copy keeps its own placement and size.
The Active Shape section tells you whether the layer is Independent or Linked with the number of instances. A chain icon marks linked layers in the list.
Make Independent detaches the active layer from its family. For a group it also detaches its members and nested groups, keeping their current look. Undo restores the link.
Regular duplicates are independent
A normal duplicate never shares parameters with the original. Use Alt+D when you want edits to follow.
Merge Down¶
Merge Down freezes the active layer and the one directly below it into a single Merged Image layer, at the current export resolution.
- Both layers must be visible, adjacent, not masks, and either in the same group or both ungrouped.
- Locked layers, and layers that other layers depend on as masks or booleans, cannot be merged.
- The result can still be moved, rotated, scaled, hidden, locked and masked, and merged again. It no longer has shape or modifier parameters.
- Ordinary Undo brings back both original layers.
Choose the resolution first
A merge is exact at its own resolution and approximate after resampling or transforms. Set the export resolution before merging if small details matter. The default comes from the add-on Preferences, and the Save As dialog of the Library lets you change it.