Skip to main content

Excel Populate in Zapier

Excel - Populate is a Zapier action that fills an .xlsx template with JSON data and returns the populated workbook, preserving every cell style, formula, and merged region. Use it when you already have a branded Excel layout and want new data slotted into it automatically. The action takes a template file plus a JSON payload and returns a filled .xlsx, so you can email, upload, or archive it without any manual paste.

Related Blog Posts
No blog post yet for this feature — coming soon.
In the meantime, browse the PDF4me blog for tutorials and workflows across every platform.
Visit the blog →

Authenticating Your API Request

Every PDF4me module in Zapier requires a valid connection. Create or select one that holds your PDF4me API key.

Important Facts You Should Not Miss

Template layout is preserved exactly
Populate operates on cell values, not styles. Fonts, colors, borders, merged cells, row heights, column widths, images, and formulas defined in the template all survive. Only the cells you mark for population are touched.
Template needs Smart Markers or a table
PDF4me writes JSON into cells that either carry Aspose Smart Markers like &=Items.ItemName or sit inside an Excel table whose column headers match the JSON field names. A plain blank sheet produces an empty output.
Template field wants a file, not a URL
Map 2. File from a Dropbox / Google Drive / OneDrive Get File step. Template URL is only for public HTTPS-served templates and stays blank whenever you're passing a mapped file.
Zapier Excel - Populate action Configure tab showing Template mapped to 2. File, Template URL empty, Template Name assembled from 2. File Name plus 2. File Ext .xlsx, and JSON Data containing an Items array with objects that have ItemName, Qty, and UnitPrice fields.

Top of Configure. Map Template from the previous step's file output, then build Template Name by concatenating File Name and File Ext. JSON Data is the payload PDF4me writes into the template.

What is Excel - Populate in Zapier?

Excel - Populate is Zapier's PDF4me action for filling a pre-designed .xlsx template with data from a JSON payload. It accepts a template file plus a JSON object and returns a filled workbook file. Unlike an online JSON-to-Excel converter that flattens everything to a raw grid, Populate preserves the template's layout, so branded reports, invoices, and dashboards can be regenerated on every trigger without formatting drift.

Parameters

ParameterRequiredWhat it doesExample
TemplateConditionalThe .xlsx template file. Map from a Dropbox / Drive / OneDrive Get File step. Required unless Template URL is set.2. File
Template URLConditionalPublic HTTPS URL to fetch the template. Used only when Template is blank.https://example.com/tpl.xlsx
Template NameRequiredFilename with extension. Used for output naming and downstream mapping. Typically built by concatenating File Name and File Ext from the prior step.Items.xlsx
JSON DataRequiredData payload to write into the template. Object keys must match Smart Markers or table column headers.{"Items":[{"ItemName":"A123","Qty":"55","UnitPrice":"3.05"}]}
Strict JSON StringsOptionalWhen True, quoted numbers stay as strings in the output cells. When False, they auto-convert to numeric cells.True
Culture & Language SettingsOptionalLocale used to parse date and numeric cells. Does not modify stored values.en-US
Calculate FormulasOptionalWhen True, formulas in the template are evaluated after population so totals open pre-computed.True
Worksheet IndexesOptional1-based index of the worksheet(s) to populate. Comma-separated for multiple sheets in one call.1 (or 1,3)
Quote Prefix To StyleOptionalWhen True, cells beginning with a single quote are styled as text rather than treated as a prefix character.False
Zapier Excel - Populate Configure tab scrolled down showing Strict JSON Strings True, Culture and Language Settings en-US, Calculate Formulas True, Worksheet Indexes 1, and Quote Prefix To Style False.

Advanced options. Strict JSON on and Calculate Formulas on are the two defaults you almost never want to change. Adjust Worksheet Indexes only if the template's data area lives on a sheet other than the first.

Output

FieldTypeWhat it contains
FileBinaryThe populated .xlsx workbook. Map into a Dropbox / Drive / OneDrive Upload File step, or attach it in Gmail / Outlook Send Email.
File NameStringThe Template Name you provided in the Configure tab. Useful when the upload step needs both file bytes and a filename separately.

How does Excel - Populate work in Zapier?

Zapier passes the template file bytes and the JSON payload to PDF4me's /api/v2/PopulateExcelTemplate endpoint. PDF4me opens the template with Aspose Cells, resolves every Smart Marker or table binding against the JSON, evaluates any dependent formulas, and returns the populated .xlsx as a Base64-encoded byte stream that Zapier surfaces as the File output. Per the Zapier documentation on file fields, that File output can be dropped into any subsequent action that accepts a file input, without a manual encode or decode step.

Common Questions

What file types can I use with Excel - Populate?+
The template must be an .xlsx (Excel 2007 or later). Data is provided as JSON, either pasted directly into the JSON Data field or mapped from a prior step that produces JSON. Legacy .xls templates should be re-saved as .xlsx before use.
How do I convert JSON to Excel in Zapier?+
Design an .xlsx template with Aspose Smart Markers (like &=Items.ItemName) or a table whose column headers match the JSON field names, then use Excel - Populate to write the JSON rows into that template. The output preserves every style, formula, and merged region from the template. See the Aspose Smart Markers reference for the exact marker syntax.
How much does Excel - Populate cost in credits?+
Excel - Populate consumes one PDF4me credit per run, regardless of how many rows the JSON payload contains. Free-tier accounts include a daily credit allowance; paid plans increase the limit. See the pricing page for the current per-tier allocation.
Can I populate multiple worksheets at once?+
Yes. Set Worksheet Indexes to a comma-separated list like 1,3 and shape the JSON payload as an array of arrays, one per target sheet. One call fills every listed sheet in a single PDF4me request, saving both credits and Zapier task usage.
Why is my Excel - Populate returning an empty workbook?+
The template has no Aspose Smart Markers and no Excel table with matching column headers. PDF4me populates by matching JSON field names to template markers. Open the template and add markers like &=Items.ItemName in the first row of the data area, or convert the data range to a table whose column headers match the JSON keys.