> For the complete documentation index, see [llms.txt](https://zenshaders.gitbook.io/zenshaders-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zenshaders.gitbook.io/zenshaders-docs/how-to-use/decals.md).

# Decals

## Blender

Decals are mesh planes with pre-built materials, designed to be placed on surfaces to add detail. They are scaled to real-world size.

{% stepper %}
{% step %}
Open the **Asset Browser** and select the **ZenShaders Decals** library.
{% endstep %}

{% step %}
Browse the categories and find the decal you want.
{% endstep %}

{% step %}
**Drag and drop** the decal into the **3D Viewport**. It will appear as a plane in your scene.
{% endstep %}

{% step %}
Move and position the plane on your surface manually.
{% endstep %}

{% step %}
To project the decal onto a surface (like a stamp), add a **Shrinkwrap modifier** to the decal plane and target it to your mesh.
{% endstep %}
{% endstepper %}

{% hint style="success" %}
Decals are also well-suited for use inside **Geometry Nodes** setups — for example, scattering leaf decals across a tree or plant mesh.
{% endhint %}

{% hint style="warning" %}
Decals use transparent materials. Make sure your viewport shading is set to **Material Preview** or **Rendered** mode to see them correctly.
{% endhint %}

## Substance Painter

Decals are stamp materials in `.sbsar` format that Substance Painter automatically recognizes as stamps.

{% stepper %}
{% step %}
After importing, go to the **Shelf** and find the decal under the **Decals** or **Materials** category.
{% endstep %}

{% step %}
**Drag and drop** the decal from the Shelf onto your model. Substance Painter will automatically detect it as a stamp.
{% endstep %}

{% step %}
Use the **Scale**, **Rotate**, and **Position** handles to adjust the decal placement.
{% endstep %}
{% endstepper %}

{% hint style="success" %}
For fine placement control, work in the **UV view** to position stamps precisely.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://zenshaders.gitbook.io/zenshaders-docs/how-to-use/decals.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.