Epistola Suite

Suite Documentation

Reference guides for every part of the Epistola document generation platform.

Core Concepts

Templates

The core resource in Epistola: name, data contract, data examples, settings, and the template detail page.

Data Contracts

JSON Schema data contracts defining template input structure, named data examples, and the data contract editor.

Variants

Presentation variations of a template with attribute-based resolution, scoring, and default fallback.

Versions

Numbered version lifecycle per variant: Draft, Published, and Archived states with immutability guarantees.

Version Comparison

Side-by-side PDF preview comparing two versions of a variant with data example selection.

Environments

Tenant-scoped deployment targets for version activation and the deployment matrix.

Deployment Matrix

Visual matrix of active versions per variant per environment with inline version selection and auto-deploy.

Themes

Reusable style definitions with document styles, page settings, block style presets, and a multi-level style cascade.

Stencils

Versioned, reusable template components with insert-as-copy semantics and bulk upgrade propagation.

Editor

Editor Overview

Full-page WYSIWYG editor with split view, live PDF preview, autosave, undo/redo, and stencil management.

Block Types

Content, layout, logic, and page blocks: text, tables, images, containers, conditionals, loops, and more.

Expressions

Three expression languages — JSONata, JavaScript, Simple Path — with live evaluation and inline chip rendering.

Rich Text

ProseMirror-based inline editing with formatting, lists, links, and expression chip insertion.

Generation & Output

Document Generation

Three generation modes — sync preview, async single, async batch — with variant resolution and schema validation.

Jobs

Job lifecycle from PENDING to COMPLETED, per-item batch tracking, filtering, and cancellation.

Rendering

iText Core PDF engine, Playwright HTML fallback, PDF/A-2b compliance, and output formats.