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

# Table

<figure><img src="https://2449056524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6BdQXak9wiY4BdSf9Rq%2Fuploads%2FUyhINIrq9cYzGV0xtFrO%2FScreenshot%202026-06-07%20at%2011.15.38%E2%80%AFAM.png?alt=media&amp;token=bac63a7b-06b0-470b-a5a7-f7581cb45434" alt="" width="349"><figcaption></figcaption></figure>

Quickly create customizable <mark style="color:$success;">**Tables**</mark> with the ability to add any content into cells, styled as you'd like, with styling for row/column borders, and the table as a whole. Add a new "Table" layer to get started.

***

## Adding Rows & Columns

<figure><picture><source srcset="/files/Y6VJ1M8UZxxEKouRnSN0" media="(prefers-color-scheme: dark)"><img src="https://2449056524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6BdQXak9wiY4BdSf9Rq%2Fuploads%2FAuHBhFZGMge53B0jS73u%2FScreenshot%202026-06-07%20at%2012.35.48%E2%80%AFPM.png?alt=media&amp;token=807430c5-021f-4092-a175-0c04e44179b3" alt="" width="375"></picture><figcaption></figcaption></figure>

In the Table component, add or remove columns and rows. If you remove a row with content, the content will be deleted, but you can undo this operation.

<figure><img src="https://2449056524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6BdQXak9wiY4BdSf9Rq%2Fuploads%2FrT9dtQjXxaQFIdBI2pX8%2FScreen%20Recording%202026-06-07%20at%2011.21.34%E2%80%AFAM.gif?alt=media&amp;token=c8a06f78-cc89-4773-adef-73c1a1bc58b5" alt="" width="512"><figcaption></figcaption></figure>

Rows are added at the bottom, columns added on the right. The pivot determines how the table grows. In this example, the pivot is "Top" / "Center". Adding rows will expand the table down, while adding columns expands evenly left and right due to the centered pivot.

***

## Table Layer Details

The Table comes with child layers. One layer for each cell (top left is "Cell 1,1"), and one layer for each row and column border, left to right, top to bottom.

These layers are used to hold content (cell layers) and to style the layers, such as changing the color of the column or row borders.

### Cell Size

The Table component can *Fit Cell to Content*, which will automatically set the width and height of the cells to match the greatest in the row or column.

Otherwise, you can set the width and height directly.

### Cell Padding

<figure><picture><source srcset="/files/gA51ARby6mqRcxZjB4Ss" media="(prefers-color-scheme: dark)"><img src="https://2449056524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6BdQXak9wiY4BdSf9Rq%2Fuploads%2F7qsIn9wkGjYMDrtIiyzB%2FScreen%20Recording%202026-06-07%20at%2012.38.07%E2%80%AFPM.gif?alt=media&amp;token=56912ba2-6c3a-4642-b21f-4bb5d64ab0bb" alt=""></picture><figcaption></figcaption></figure>

Padding on all four sides can be adjusted independently.

### Grid Line Size

Vertical grid lines, and horizontal grid lines can have their thickness increased on the Table level. However, lines can each have additional styling applied if you choose, by adding components to the Row and Column "Line" layers.

You can also choose to have "Dashed" lines, and then set the length of those lines.

### Mask Cells

By default, cells are masked, so content within them is contained to the bounds of the cell + padding. You can turn this off.

<figure><img src="https://2449056524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6BdQXak9wiY4BdSf9Rq%2Fuploads%2FXGgMYtzCoSjp89ufFxRH%2FScreen%20Recording%202026-06-07%20at%2012.42.31%E2%80%AFPM.gif?alt=media&amp;token=3bb9b4f2-a3a9-400a-8c19-73bfb71ad5b0" alt=""><figcaption></figcaption></figure>

***

## Styling Cells

By default, a Cell layer has no components, and is fully transparent. If you'd like add color to the cell background, add a Rectangle component, and then you can add a Fill or other fill components.

<div><figure><img src="https://2449056524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6BdQXak9wiY4BdSf9Rq%2Fuploads%2FKI4oOTK43Y1y1EFM28tp%2FScreenshot%202026-06-07%20at%2011.26.51%E2%80%AFAM.png?alt=media&amp;token=16fd07f6-393d-4960-a023-1e8ce50345a6" alt=""><figcaption></figcaption></figure> <figure><img src="https://2449056524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6BdQXak9wiY4BdSf9Rq%2Fuploads%2FSoDrQh1HRNhlEDOzYzTN%2FScreenshot%202026-06-07%20at%2011.26.56%E2%80%AFAM.png?alt=media&amp;token=a45ea69a-23a6-49ad-a471-6d1a52957377" alt=""><figcaption></figcaption></figure></div>

Any components added will affect the cell. Below, a [3D Lift](/docs/design/templates-design-your-cards/components/3d-lift.md) was added to the "Converters" cell.

<figure><img src="https://2449056524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6BdQXak9wiY4BdSf9Rq%2Fuploads%2F8ZFkJbUbWmj7A2OEB928%2FScreenshot%202026-06-07%20at%2012.29.37%E2%80%AFPM.png?alt=media&amp;token=af7351fb-e599-40f7-8bfc-decfbb72685b" alt="" width="274"><figcaption></figcaption></figure>

***

## Adding Content to Cells

Any layers added as a child to the Cell layer will display within the cell, and act as normal. Simply add a new layer as a child of a Cell layer.

<div><figure><picture><source srcset="/files/J3POkgsnBmlMtYCsZR26" media="(prefers-color-scheme: dark)"><img src="https://2449056524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6BdQXak9wiY4BdSf9Rq%2Fuploads%2FAs9Hme0wrOYfMonm0ecA%2FScreenshot%202026-06-07%20at%2012.44.48%E2%80%AFPM.png?alt=media&amp;token=6b4504d1-32c8-4605-832e-d85526398fdf" alt=""></picture><figcaption></figcaption></figure> <figure><img src="https://2449056524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6BdQXak9wiY4BdSf9Rq%2Fuploads%2FDYVSvkKjiOYnd7nlh6wh%2FScreenshot%202026-06-07%20at%2012.44.51%E2%80%AFPM.png?alt=media&amp;token=67374d8b-ba74-44b0-9e68-1d1cf5817194" alt=""><figcaption></figcaption></figure></div>

***

## Styling Grid Around a Single Cell

The built-in styling handles entire row/column grid lines. The cell can overlay its own border on top of those grids. Add a Outline onto the cell layer.

<div><figure><img src="https://2449056524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6BdQXak9wiY4BdSf9Rq%2Fuploads%2FgHPTLzV3AOccxfuc0sLi%2FScreenshot%202026-06-07%20at%201.46.35%E2%80%AFPM.png?alt=media&amp;token=44313f66-b6b2-4031-a897-998bc2a0ae9a" alt=""><figcaption></figcaption></figure> <figure><picture><source srcset="/files/3t2QfoeFKODo9FDq2bio" media="(prefers-color-scheme: dark)"><img src="https://2449056524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK6BdQXak9wiY4BdSf9Rq%2Fuploads%2FazUiMkeRGiecDV1ZZUBr%2FScreenshot%202026-06-07%20at%201.46.57%E2%80%AFPM.png?alt=media&amp;token=d222b02d-4283-4908-9725-e55e0726637f" alt=""></picture><figcaption></figcaption></figure></div>

Set the Outline *Position* to "Inside", so that it covers the grid line fully. If your grid lines are thicker, you will need to adjust the values and perhaps the *Position* to "Middle".


---

# 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/table.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.
