Skip to main content
Creates an Excel document (.xlsx) from a template by filling in placeholders with dynamic values from your Workflow. With Cassidy’s Excel document templates, you can:
  • Generate standardized invoice reports that consolidate data from multiple PDF invoices into a consistent format
  • Create financial summaries with automatically calculated totals and formatted currencies
  • Produce inventory sheets that expand horizontally and vertically based on your data
  • Build dynamic pricing tables that adapt to product lists of any size
  • Generate expense reports with formulas that compute totals, taxes, and approvals
1

Add the action

In the Workflow builder, click + between blocks and select Create Microsoft Excel Document from Template from the action library.
Action library with Create Microsoft Excel Document from Template selected
Adding the Create Microsoft Excel Document from Template action between blocks
2

Upload the Excel template

Click to upload your Excel document template (.xlsx file) that contains placeholders for dynamic content. See Template placeholders below for how to set up your template.
Uploading an Excel template file
3

Enter the output document name

Provide a name for the generated Excel document. This will be the filename when the document is created. You can use variables from previous steps.
Output document name field with variable support
4

Configure template fields

Under the Template Fields section, map each placeholder in your template to a variable from previous Workflow steps or trigger inputs.For example, in an invoice summary template:
  • {invoices} maps to a list variable containing objects with “invoiceNumber”, “totalAmount”, “date”, “dueDate”, and “items” properties
  • {grandTotal} maps to a calculated total from your data processing
  • {hasVAT} maps to a boolean variable that controls whether to show the VAT requirements row
Template fields configuration with variable mappings
5

Preview and download the document

After running the Workflow, preview the generated Excel document and download it by clicking the icons next to the action in the results panel.
Preview and download icons in the results panel
6

Attach the document to other actions (optional)

You can use the generated Excel document as an attachment in other actions like Send Email. Reference the Excel document output from this action when configuring email attachments.
Attaching the Excel document to a Send Email action

Template placeholders

Use placeholders in your Excel template to define where dynamic content should appear. Cassidy detects these placeholders when you upload the template and lets you map them to Workflow variables.
Excel template with placeholder syntax examples

Text placeholders

Use text placeholders to insert text, numbers, or formatted content from your Workflow data. Syntax: {variableName}
Text placeholder examples in an Excel template

Conditionals

Use conditionals to display rows or cells only when certain conditions are true, or to show alternative content when conditions are false. Syntax:
  • Standard: {#if:conditionName}{/if:conditionName}
  • Inverse: {^if:conditionName}{/if:conditionName}
The beginning and end of the conditional must be on the same row but in different cells.
Conditional row that only appears when hasVAT is true

Loops

Use loops to create multiple rows or columns from arrays of data. Syntax:
  • Vertical loops (for rows): {#loop:arrayName}{/loop:arrayName} — the beginning and end must be on the same row but in different cells
  • Horizontal loops (for columns): {>loop:arrayName} — no closing tag needed, place child properties in the same cell
Vertical loop example with nested line items
To render correctly, items must be a list where each item has the necessary properties (such as description in this case).

Inner loops

When the loop start and end are in the same cell, content repeats within that cell instead of creating new rows. Template:
Inner loop template with start and end in the same cell
Output:
Inner loop output with multiple values in one cell

Horizontal loops

Use the > prefix to expand data horizontally across columns. Template:
Horizontal loop template expanding across columns
Output:
Horizontal loop output with data expanded across columns

Nested loops

You can nest loops to handle multi-level data like invoices with multiple line items. Template:
Nested loop template with invoices and line items
Output:
Nested loop output with expanded invoices and line items

Variable scope in loops

When you’re inside a loop, you can access both properties of the current item and properties from outside the loop:
  1. Properties of the current item — use the field names directly
  2. Properties from outside the loop — these remain accessible

Data format for loops

If your template has this loop structure:
{#loop:items}{description}{/loop:items}
Your data must have an array with properties that match the placeholder names exactly:
{
  "items": [
    {"description": "Web Design Services"},
    {"description": "Monthly Hosting"}
  ],
  "grandTotal": "$2,500.00",
  "hasVAT": true
}

Troubleshooting

If you see template tags like {invoiceNumber} in the final output, double-check that:
  • The variable names in your data match the tag names exactly (case-sensitive)
  • Your data is properly formatted JSON