Your First Decal (5 min)¶
This guide takes you from an empty scene to a decal placed on a model.
What you will build: a small rounded panel with two screws, placed on a surface.
Step 1 — Open the panel¶
Hover the 3D Viewport, press N and open the Decal Workshop tab.
Step 2 — Create a decal¶
Click
Create Decal.
Decal Workshop opens a dedicated scene for editing and leaves your original scene untouched. You see a flat canvas and the sidebar switches to the editing panels.

Step 3 — Draw a panel¶
In the Create section, click
Panel, then drag in the viewport to draw it.
- Drag the shape to move it.
- Drag a small corner handle to resize it.
- Drag the point above the shape to rotate it.
Orbit around the canvas: the relief is live.
Step 4 — Add screws¶
Click
Screw, then click where you want the center and drag to set the size. Repeat for a second screw.
Grid and snapping
Use the Show Grid and Snap buttons of the grid row to place shapes precisely. Hold Ctrl to toggle snapping temporarily.
Step 5 — Check it on a surface¶
Click
Test on Surface.
Point at a mesh and the decal previews on it:
| Action | Result |
|---|---|
| Mouse wheel | Change the size |
| Shift + wheel | Rotate |
| Left click | Put the decal here |
| Esc | Cancel |
If the scene has no mesh, a test sphere named Decal Test Surface is added for you.
Step 6 — Leave editing¶
Click
Exit Editing. Decal Workshop returns to your scene, view and selection. You can come back at any time with
Resume Editing.
Step 7 — Place the decal from the library¶
- Select a mesh in Object Mode.
- In the Library section, pick an entry.
- Click
Place on Surface and click on the mesh. - Press Space or Enter to validate.
Library
Library pages are coming. For now, see Place on Surface for the placement itself.
Troubleshooting¶
Place on Surface is greyed out
Select a plain mesh in Object Mode and choose an entry in the Library first.
I do not see relief
Orbit the view and use Material Preview shading. A decal seen straight from the front shows little relief.