> 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/components/fill-components.md).

# Fill Components

There are three "Fill" type components:  <mark style="color:$success;">**Fill**</mark>, <mark style="color:$success;">**Gradient Fill**</mark>, and <mark style="color:$success;">**Image Fill**</mark>.

Each of these will work with each other, and their effects are calculated in the Component Stack order, with the first Component (higher in the stack) computed first.

***

## Common Properties

All three Components have a *Blend* value, which determines how the visuals blend with the underlying layers.

They each also have an *Opacity* value which handles their own opacity. The **Gradient Fill** has a gradient for the opacity.

***

## Fill

<figure><img src="https://2449056524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6BdQXak9wiY4BdSf9Rq%2Fuploads%2FOEJdR5uPtZ4zwaeTsB6X%2FScreenshot%202026-05-22%20at%204.41.31%E2%80%AFPM.png?alt=media&amp;token=42d3ea1e-d08e-4d40-8d43-c0c00662ea10" alt="" width="563"><figcaption></figcaption></figure>

<mark style="color:$success;">**Fill**</mark> has a *Color* value that will fill the shape with the chosen color.  Like all properties, you can link this to a [Variables](/docs/design/templates-design-your-cards/variables.md) to drive the color dynamically, so each Card in your Deck can have its own color.

<figure><picture><source srcset="/files/Eq281GMudU84vs33tn2K" media="(prefers-color-scheme: dark)"><img src="https://2449056524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6BdQXak9wiY4BdSf9Rq%2Fuploads%2FXMAFrev8aNOX4BHkwuxO%2FScreenshot%202026-05-22%20at%204.41.40%E2%80%AFPM.png?alt=media&amp;token=ced7a041-f8bc-43d6-9030-180e136c831a" alt="" width="304"></picture><figcaption></figcaption></figure>

You can also set this to be a [Global Values](/docs/design/global-values.md), which is useful for when you want to tweak a specific color — any Templates using the **Global Value** will be updated.

***

## Gradient Fill

<div><figure><img src="https://2449056524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6BdQXak9wiY4BdSf9Rq%2Fuploads%2FSc0LKD0J3bwhqZmUIpKG%2FScreenshot%202026-05-22%20at%204.44.57%E2%80%AFPM.png?alt=media&amp;token=a20c8038-b41f-491c-9222-1acd4fa2ded7" alt=""><figcaption><p>Type: Linear</p></figcaption></figure> <figure><img src="https://2449056524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6BdQXak9wiY4BdSf9Rq%2Fuploads%2FQe5DPIVNS0G4p90sQvX1%2FScreenshot%202026-05-22%20at%204.45.19%E2%80%AFPM.png?alt=media&amp;token=e709d1a1-176c-4255-bdf0-5ccfa2c5aeb7" alt=""><figcaption><p>Type: Radial</p></figcaption></figure></div>

<mark style="color:$success;">**Gradient Fill**</mark> lets you create a gradient, including opacity. You can set the *Type* to be "Linear" or "Radial".

### Scope for Text

The <mark style="color:$success;">**Scope**</mark> determines how the bounds of the gradient are calculated. "Per Letter", "Per Word", "Per Line", or "Per Block" which is the entire text block.

***

## Image Fill

<mark style="color:$success;">**Image Fill**</mark> accepts an image, and works great with tileable images.

<figure><img src="https://2449056524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6BdQXak9wiY4BdSf9Rq%2Fuploads%2FH3ocmZyeO5XhKThOoPb2%2FScreenshot%202026-05-22%20at%206.41.39%E2%80%AFPM.png?alt=media&amp;token=d7ddce51-851c-48f8-a1cb-0d0f9c52fafe" alt="" width="563"><figcaption></figcaption></figure>

Try playing with the *Blend Mode* and matching with **Fill** or **Gradient Fill**.

<figure><img src="https://2449056524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6BdQXak9wiY4BdSf9Rq%2Fuploads%2FwGphOqJpVnxFlwHNImIb%2FScreenshot%202026-05-22%20at%206.42.10%E2%80%AFPM.png?alt=media&amp;token=8e37a64f-de64-4f0e-bd30-5783f9a86977" alt="" width="563"><figcaption></figcaption></figure>

### Scope for Text

The <mark style="color:$success;">**Scope**</mark> determines how the bounds of the image are calculated. "Per Letter", "Per Word", "Per Line", or "Per Block" which is the entire text block.


---

# 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/components/fill-components.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.
