Row values

Each row of a batch gives the template's variables their values. This page lists what every kind of value accepts, where you set it in the batch builder, and what happens when a cell is left empty. For the same values as JSON, see Row data.

Text

Type in a text cell, or fill the column from your sheet. The text replaces the layer's text for that row.

• An empty cell, or one that only contains spaces, keeps the template's text (its Text Content).
• Typing the template's own words changes nothing, so those rows keep the designed styling.
• The File Name cell works the same way: leave it empty and the default name (batch_#) is used.

On a template with several pages, each page reads its own column, named page1@Title, page2@Title and so on in page order. A plain Title column fills every page that has no column of its own. See Fill several pages from one sheet.

Styled text

Some text layers use more than one style, for example a headline with two words in an accent colour. Kalpana names the distinct styles s1, s2 and so on. s1 is the style of the first run of text and is the default.

You never type tags in the Studio:

1. Click the text cell. A popover opens with a chip for each style (s1, s2, ...) above the text field. Hover a chip to see its sample text, font and size.
2. Select words and click a chip to apply that style to them. With nothing selected, pick a chip and then type: the new text uses that style.
3. Press Enter to add a line break. In the grid a line break shows as a return symbol.

The words in the editor appear in each style's colour for that row. If a colour would not be readable on the field, such as near white in light mode, the run is underlined instead.

Where the text comes from a sheet or CSV, the cell is plain text and renders entirely in s1. To style words from a sheet, wrap them in tags: <s1>Your AI agent now </s1><s2>designs</s2>. A style that does not exist in the template, or tags that are not paired, fall back to plain s1 text and nothing fails. The Quick generate and duplicate forms edit styled text in place instead of in a popover.

Images

An image cell holds the image for that row. Click Pick Image to open the picker:

• Choose an image from the workspace library, searching by name or filtering by collection.
• Upload a file, drag and drop one, or paste one from the clipboard. Files must be images, up to 5 MB and 5000 x 5000 pixels.
• Paste an https:// link into the search box to import it. The link's domain must be on the workspace's domain whitelist, otherwise Kalpana shows a Domain Not Whitelisted error and asks you to add it in the workspace settings.

When you import a sheet, an image column can hold an image's file name or id from your library (the extension is optional and the match ignores case) or an https:// link. A cell that cannot be matched or fetched is flagged on its row. Use the x in the cell to remove a picked image.

An empty image cell keeps the template's own image.

Fit, zoom and position

With the live preview open, the Image fit panel lists each image variable of the row. Open its Fit and position section to set:

The frame itself never changes size, so a tall product and a wide product in the same slot do not move the layout around them. Adjusting an empty cell re-fits the template's own image. Reset returns a row to the template's setting, and the copy and paste buttons move an adjustment between rows.

Colours

Colours are not variables you add. The Colours cell of a row shows its colours as swatches, and clicking it opens the Colours panel for that row, split into Background and Text. Pick a solid colour or a gradient for any slot. Reset on a slot, or Reset all to template, returns it to the template's colour.

A text with several styles has one colour slot per style, so you can recolour s2 without touching s1. Colour changes apply to that row only.

Visibility

The layers icon at the start of a row opens Layer Visibility, with an eye button for each layer. Turn a layer off to hide it for that row; the template is unchanged. In the live preview each variable also has a switch to show or hide it.

A layer that is hidden in the template itself shows as Hidden (layer disabled) in the grid and cannot be edited.

Output format

The Format cell sets the file type of each row. See Preview rows.

When copy is too long

Kalpana does not shorten or reject long text. What happens depends on how the layer was designed:

• In a fixed-size box the text can run past the box and be clipped.
• With Auto Resize on, a fixed-size box shrinks the font down to a minimum scale so the text fits. This is skipped for text that contains lists.
• A box set to grow in height pushes the content after it down. If the page is a fixed size, whatever ends up below the page edge is cut off.

Check the longest row in the live preview before you create the batch, and keep copy close to the length of the template's sample text.