Skip to content

Preferences

Open the preferences in Blender: Edit > Preferences > Add-ons > Decal Workshop.

The preferences have four tabs: Info, Options, Keymaps and Links. Defaults for new decals are set here. A decal that already exists keeps its own values.

The preferences tabs


Info

Option Effect
Check for Updates Off by default. When on, a Check for Updates button tells you whether a new version is out. This needs Allow Online Access in Blender Preferences > System. When a new version exists, the panel header shows it
Documentation Opens the online documentation
Show Addon Help Shows or hides the small ? help buttons next to the sections of the panel
Shop and Discord buttons Links to the add-on pages and to customer support

Options

The top of the tab holds the Settings File. Below it, foldable boxes (closed by default) group the settings.

Settings File

Button Effect
Settings file path A JSON file. If it already exists, it is loaded right away
Save Writes the add-on preferences and your keymaps to the file
Load Reads them back and applies them
Reset Preferences Puts every preference back to its default

Use it to carry your setup from one Blender installation to another.

Library

Option Effect
Add-on library The folder of the decals shipped with the add-on. It is editable
Your libraries A list of your own library folders. Use the plus and minus buttons to add or remove one, then set its Folder. Each appears as a User Library button in the library
My Materials Folder Where saved materials live. Empty uses the Blender config folder

See The Library and Materials and Finishes.

Gizmos & Board

Option Effect
UI Scale Size multiplier for Decal Workshop gizmos, buttons and viewport labels
Follow Blender UI Scale Off: gizmos keep the same pixel size whatever Blender's scale. Other choices follow Blender's resolution scale
Board buttons The row of buttons at the top of the editing view: Position (Top or Bottom), Vertical Offset, Horizontal Offset, Button Size, Button Spacing, Group Gap
Shape buttons The column next to the active shape: Button Size, Button Spacing, Offset X, Offset Y

A reset button restores the board layout.

Colors

Change the colors of the editing view: the Canvas Background, a Preset menu (save your own with the plus button), an Adjust All Colors box (Hue, Saturation, Value), and a list of colors for the individual gizmos and overlays. The exports always use the default canvas color. A reset button restores the colors.

Placement

Option Effect
Projection Grid Resolution of the grid that wraps a placed decal on its surface, for new placements
Parallax Whether a newly placed decal uses parallax
Parallax Strength Parallax strength of a newly placed decal

See Place on Surface.

Export

These are the defaults of a new decal.

Option Effect
Export Resolution Resolution of the maps saved to the library: 512, 1024 or 2048
Export AA Anti-aliasing of those maps: Off, 2 x 2 or 4 x 4
Save Scope What Save As stores by default: Selection / Group or Whole Decal
Thumbnail Render Fast Preview or Studio
Shapes without material Color, Metallic and Roughness used in thumbnails and exports for shapes that have no material
Studio backdrop Color, Metallic and Roughness of the backdrop of the Studio thumbnail, for decals with a material. Active in Studio mode

Quality

Option Effect
Preview Refine Delay Seconds without any change before the preview is refined to full quality (0.05 to 2)

Keymaps

The tab lists the shortcuts the add-on registers in Object Mode, and lets you change each one like any Blender shortcut.

Shortcut Action
Del Delete the selected shapes and groups
X Delete, after a confirmation
Ctrl+D Duplicate
Shift+D Duplicate, then move
Alt+D Duplicate as a linked instance
Tab Edit a text layer in the viewport

The shortcuts of the editing tools (G, R, S, Ctrl+G ...) belong to the Edit Shapes tool and are listed in Shortcuts. Your keymaps are saved in the Settings File.


Links to the author's tutorials, shops and social pages.


Next steps