Data Merge
Definition
A CE.SDK Starter Kit for generating batches of personalized assets by injecting rows of structured data (from a CSV or spreadsheet) into a template and exporting one file per row, using CE.SDK’s variable and placeholder APIs with the headless engine. It is the standard pattern for direct mail, event badges, certificates, team cards, and personalized marketing at volume.
Data Merge differs from Multiple Image Generator in its input model: Data Merge produces many outputs from many data rows: the same template, different data per output. Multiple Image Generator produces many format variants from one data point: multiple templates, same data. Both use CE.SDK’s headless API for generation without UI interaction.
How Data Merge Works
Prepare the Template
A designer authors the template in CE.SDK’s editor, placing text variables (e.g., {{name}}, {{company}}) and image placeholders where per-row data will be injected.
Upload the Data Source
A CSV or spreadsheet is uploaded or connected. Column headers map to template variable names. Each row becomes one output file. Image columns reference URLs or asset paths for placeholder filling.
Batch Generation
CE.SDK’s headless engine iterates over the data rows. For each row: load template, inject row data, export output file. The batch completes with one exported file per data row, ready for download, delivery, or print fulfilment.
Common Product Categories
Event Badges & Credentials
Name badges, conference lanyards, and attendee credentials. One template, one CSV, one export run produces a uniquely addressed badge for every attendee.
Certificates & Diplomas
Completion certificates, award letters, and credentials. Names, dates, and scores injected per recipient row, exported as individual print-ready PDFs.
Direct Mail Postcards
Personalized postcard and direct mail campaigns. Recipient name, address, and offer details filled per row from a CRM or mailing list export.
Team & Player Cards
Sports team cards, staff directories, and employee profiles. Photo URL, name, role, and stats columns in the CSV map to image placeholders and text variables in the template.
Product Catalogs
One product card template, one row per SKU in the spreadsheet. Name, price, image URL, and description columns fill the template for each product in the catalog.
Personalized Marketing Assets
Account-based marketing materials, loyalty reward cards, or anniversary messages. CRM data drives per-recipient personalization at scale without manual design work.
Typical Use Cases
Event & Conference Organizers
An organizer uploads a CSV of 500 attendee names and company names. The Data Merge Starter Kit loads a name badge template, injects each row, and exports 500 individual badge images, ready to send to the badge printer in one operation.
Direct Mail Automation
Combining Data Merge with the Postcard Editor’s template system: campaign managers upload a recipient list, the engine injects recipient-specific data into the postcard template per row, and exports print-ready files for the mail house.
Learning & Certification Platforms
Upon course completion, the platform triggers a Data Merge run: learner name, course title, completion date, and score are pulled from the LMS and injected into a certificate template, one PDF issued per completion event.
Sports & Media Producers
Player cards, team graphics, and stat-driven visuals are generated from a roster spreadsheet. Each player row produces a branded card image without any manual layout work per player.
Platform Availability: Web (Vanilla JS/TS, React, Vue, Angular, Svelte, SvelteKit, Next.js, Nuxt.js), Node.js (server-side via CE.SDK Renderer), Electron.
Links
Documentation and references for this concept.
Related Terms
Starter Kit
A pre-configured, production-ready CE.SDK setup for a specific use case, ready to embed, customize, and ship, providing …
Text Variable
A named dynamic token embedded in a text block whose value is set programmatically via the Variable API (engine.variable…
Creative Automation
The practice of using CE.SDK's headless API to programmatically generate large volumes of design assets from templates a…