> For the complete documentation index, see [llms.txt](https://cardstock-studio.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cardstock-studio.gitbook.io/docs/design/templates-design-your-cards/layers.md).

# Layers

Each <mark style="color:$success;">**Layer**</mark> is one element in your card. The <mark style="color:$success;">**Layer Stack**</mark> in the left panel determines the draw order, with the Layers higher up being drawn first, behind other Layers.

Add a Layer using the <picture><source srcset="/files/CtvarQiclYEzPBYFkjy6" media="(prefers-color-scheme: dark)"><img src="https://2449056524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6BdQXak9wiY4BdSf9Rq%2Fuploads%2FYD0Tx8ync2QpEVpQCS7j%2FScreenshot%202026-05-20%20at%205.29.41%E2%80%AFPM.png?alt=media&amp;token=881c5aef-fe33-4520-942e-2d5eee46833a" alt="" data-size="line"></picture> button or the <img src="https://2449056524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6BdQXak9wiY4BdSf9Rq%2Fuploads%2FkGzFThR26O64ovwtGwc4%2FScreenshot%202026-05-20%20at%205.29.56%E2%80%AFPM.png?alt=media&amp;token=41cf5f86-eac4-4ba6-bfd6-5cb83c191fc4" alt="" data-size="line"> button.

<figure><picture><source srcset="/files/wrUg8mbyU92dNnA4LguP" media="(prefers-color-scheme: dark)"><img src="https://2449056524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6BdQXak9wiY4BdSf9Rq%2Fuploads%2FmOSWS8LZEpXe8I7Jc9EM%2FScreenshot%202026-05-20%20at%205.29.30%E2%80%AFPM.png?alt=media&amp;token=505e56dd-b9d5-4443-babd-78e662286764" alt="" width="326"></picture><figcaption></figcaption></figure>

Choose which kind of Layer to add. Any <mark style="color:$success;">**Layer Preset**</mark> that you have created will show in this menu as well. *Empty Layer* has only a *Transform* Component on it. Other Layer Presets come with a Main Component and sometimes other Components as well.

{% hint style="info" %}
Right-click any Layer and choose "Save New Layer Preset" to make it a Layer Preset. Choose "Make Prefab" to turn it into a Prefab.
{% endhint %}

In this example, a new *Rectangle* Layer has been added. It comes with a *Transform* and *Rectangle* Component.&#x20;

<figure><picture><source srcset="/files/zcb69X4Nomp3qtNKxAeK" media="(prefers-color-scheme: dark)"><img src="https://2449056524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6BdQXak9wiY4BdSf9Rq%2Fuploads%2F1PkwsNvHVnwAmQZdlYhJ%2FScreenshot%202026-05-20%20at%205.36.39%E2%80%AFPM.png?alt=media&amp;token=11301284-626d-4f2d-b423-39c06cecb8bf" alt="" width="302"></picture><figcaption></figcaption></figure>

{% hint style="info" %}
By default, shape Layers (*Circle*, *Rectangle*, *Custom Shape*) will be black. Use a *Fill*, *Gradient Fill*, and/or *Image Fill Component* to change how they appear. Bring down the "Body Opacity" Property to remove the influence of the default black color.
{% endhint %}

***

## Default Layer Types

### Circle / Rectangle

These are default shapes available as primitives.Components can modify how the Shapes appear. Learn more at [Shape Layers](/docs/design/templates-design-your-cards/layers/shape-layers.md).

### Custom Shape

Choose a [Shapes](/docs/design/shapes.md) from your library to use. Components can modify how the Shape appears. Learn more at [Shape Layers](/docs/design/templates-design-your-cards/layers/shape-layers.md).

### Image

Choose a [Images](/docs/design/images.md) from your library to use. Components can modify how the Image appears. Learn more at [Image Layers](/docs/design/templates-design-your-cards/layers/image-layers.md).

### Text

Add custom Text to your design, including in-line styled text and in-line icons. Components can modify how the Text appears. Learn more at [Text Layer](/docs/design/templates-design-your-cards/layers/text-layer.md).

### Version Stamp

This is a special Text layer that automatically prints the Version number set in [Project Settings](/docs/projects/project-settings.md). Whenever you update the version in Project Settings, Version Stamp layers will be updated. Components can modify how the Text appears. Learn more at [Version Stamp](/docs/design/templates-design-your-cards/layers/version-stamp.md).

### Grid

This Layer will set the placement of child Layers into a grid formation, with optional cell styling and styling via Components of the entire grid area. Learn more at [Grids](/docs/design/templates-design-your-cards/layers/grids.md).

***

## Layer Stack

The Layer Stack contains all of the Layers that make up your Template design. Layers on top are drawn first, behind Layers on the bottom of the stack.

<figure><picture><source srcset="/files/v58RNjWhh2iIH2TufWc5" media="(prefers-color-scheme: dark)"><img src="https://2449056524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6BdQXak9wiY4BdSf9Rq%2Fuploads%2FilD2Wfoz0tpOQNyeRezy%2FScreenshot%202026-05-20%20at%205.39.38%E2%80%AFPM.png?alt=media&amp;token=68d3685a-5749-463c-a008-b0eee7f65a7c" alt="" width="327"></picture><figcaption></figcaption></figure>

### Disable a Layer

Click the <picture><source srcset="/files/fMmnfqvRUW8z7v5PQBTM" media="(prefers-color-scheme: dark)"><img src="https://2449056524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6BdQXak9wiY4BdSf9Rq%2Fuploads%2FLKk1SqbCBjvNzBBWiB98%2FScreenshot%202026-05-20%20at%205.41.21%E2%80%AFPM.png?alt=media&amp;token=88c7d19d-da9e-4fb1-8181-a41cb9282910" alt="" data-size="line"></picture> button to disable the Layer. This will also disable all children. Click again to enable the Layer. This can also be toggled in the context menu.

### Lock a Layer

Click the <picture><source srcset="/files/JDfM3bVIk1u6Jtiq0ZjZ" media="(prefers-color-scheme: dark)"><img src="https://2449056524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6BdQXak9wiY4BdSf9Rq%2Fuploads%2FcVYUXB45j7sHa9Tb9ym6%2FScreenshot%202026-05-20%20at%205.41.26%E2%80%AFPM.png?alt=media&amp;token=2cec9930-559b-4d67-8a47-0da2cf4baa7a" alt="" data-size="line"></picture> button to lock the Layer. When locked, the Component Properties can not be updated. Click again to unlock the layer. This can also be toggled in the context menu.

***

## Context Menu

Right-click the Layer to bring up the context menu.

<figure><picture><source srcset="/files/vC5tvUwFeirTyKRkAsIS" media="(prefers-color-scheme: dark)"><img src="https://2449056524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6BdQXak9wiY4BdSf9Rq%2Fuploads%2Fx5W7wuWgH91Ra03HLOrJ%2FScreenshot%202026-05-20%20at%205.40.08%E2%80%AFPM.png?alt=media&amp;token=7690ef69-3835-409c-b635-7a809074a7ca" alt="" width="327"></picture><figcaption></figcaption></figure>

### Add Child Layer

This allows you to add a new Layer as a child of this Layer.

### Duplicate

Duplicates the layer

### Make Prefab

Choose this to turn the Layer, including its children, into a Prefab. Learn more about [Prefabs](/docs/design/prefabs.md).

### Save New Layer Preset

Choose this to turn the Layer, including children, into a Layer Preset. Unlike a Prefab, these are not linked to the original. Once they are added to a Template, they are unique.

### Highlight

Choose a color to highlight the layer, making it easier to find it in the future.

<figure><picture><source srcset="/files/l5c6jY2sRAuR9JmPVJq3" media="(prefers-color-scheme: dark)"><img src="https://2449056524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6BdQXak9wiY4BdSf9Rq%2Fuploads%2FyMihNL15SlBQy4iuoJvq%2FScreenshot%202026-05-20%20at%205.47.57%E2%80%AFPM.png?alt=media&amp;token=83797388-a739-4375-a298-4355330ae7d3" alt="" width="331"></picture><figcaption></figcaption></figure>

The color you choose will be modified by the theme, so that the highlight will look correct in both light and dark themes.

### Delete

Delete the layer.


---

# 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://cardstock-studio.gitbook.io/docs/design/templates-design-your-cards/layers.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.
