To work with the report, navigate on the left hand side to the reports button (pencil button)
The editor opens on a paginated document seeded from the data room's risks, recommendations and document structure. A user can refine the narrative, restyle, manage versions and export to DOCX or PDF, while the underlying risk data stays live and in sync with all your work in Emma.
Opening a report
The editor opens from a data room's Report tab. First open. Emma generates a fresh document from the data room's current state: risks (with their levels, summaries, and recommendations), the document tree (areas, document types, documents), and cover-page metadata such as the client name, date, and any filters in effect.
The generator produces a fully structured document containing a cover page, areas as top-level sections, document types as subsections, risk tables sorted by severity, and recommendation blocks. During this phase the editor surface shows a skeleton (toolbar, sidebar, three A4 placeholders). Long reports with thousand files can take a few seconds to appear.
Subsequent opens. The saved document is loaded and the live collaborative session reconnects. The document is not regenerated; edits, free narrative, image frames, and styling all persist as part of the report itself. To update for the latest report version, use Regenerate.
Layout
The editor has three regions:
Toolbar (top, sticky): formatting tools, insertions, view controls, filters, styling, export, undo/redo, and the page counter. Sticky so it remains available regardless of scroll position.
Sidebar (left, adjustable): two tabs, outline for navigation and versions for history. Hidden on screens narrower than
lg(typically below 1024 px) to maximise document surface on smaller laptops.
Document surface (centre, scrollable): paginated A4 or Letter pages with margins, headers, footers, and live page numbers.
Editing a report
What is auto-generated and what is free-form
Reports mix two kinds of content that behave differently. Understanding the distinction matters because edits to each propagate in different ways.
Layer | Examples | Editing model |
Business objects | Risk rows, risk recommendations, document recommendations, risk-level indicators, risk summary text | Edits flow back to the underlying entities and remain canonical in Emma. Edits made elsewhere (risk matrix, document viewer) flow back into the editor live. |
Free narrative | Cover page text, introductions between sections, headings beyond the generated structure, paragraphs added by the analyst, image frames, page breaks | Free-form. Persisted as part of the report document only. Independent from the underlying data. |
The editor treats both uniformly from a typing perspective: place the cursor and type. The difference is what happens behind the scenes (see Collaboration for how business-object edits propagate across surfaces).
A practical implication: if the user edits a risk summary in the editor, that change is visible in the risks tab of the data room and in the document viewer. If the user adds a paragraph of narrative between two risks, that paragraph lives only in the report.
Free-text editing
Standard rich-text editing throughout the document.
Text formatting (selection-scoped, applied via the toolbar or shortcuts):
Bold, italic, underline, strikethrough
Highlight (yellow)
Text colour: 16 preset swatches, native colour picker, hex input
Font family per selection (the document default lives in Styling)
Block styles (line-level):
Paragraph
Heading 1 through 5
Eyebrow: small-caps decorative variant
Jumbo: oversized display
Lists and alignment:
Bullet list, ordered list, align left / centre / right. Text-style marks like font family and colour are scoped to the selection, the same way Word handles them. Changing a heading style or alignment applies to the current line.
Pasting from external sources (Word, web pages, other Emma reports) preserves basic formatting where possible. Pasted content is mapped to the editor's block styles; styles without a direct equivalent fall back to Paragraph.
Rich edition:
Image inline insertion
Frame insertion (allowing to manupulate iamge size / position)
Horizontal separator
Page break
New empty page
Page(s) background color
Editing business objects (risks and recommendations)
Risk findings, risk levels, and recommendations are surfaced as structured cells inside generated tables. The user interacts with them in three ways.
1. Edit the body text inline. Click into a risk-summary cell or a recommendation cell and type. Markdown formatting is preserved and the change is persisted to the underlying entity. While the cursor is inside one of these cells, the row is locked for other collaborators (see Live presence).
2. Use the inline action menu. A floating action menu opens from any risk row or recommendation row. It exposes:
Risk level (risk rows only): High, Medium, Low, Unspecified, No Risk. Each is preceded by a colour dot. Switching a level moves the row to its corresponding risk-level table; the table glides to its new position with a FLIP animation while surrounding content reflows.
Add Recommendation: Pre-Closing, Closing Action, Post-Closing, Specific Indemnity, Specific Tax Indemnity, Representations & Warranties, No Action Needed. Document or risk level.
View risk in document (risk rows only): opens the document viewer on the right tab, with the risk pre-selected. See View risk in document.
3. Drive changes from elsewhere. A risk level changed in the data-room risk matrix or the document viewer is patched into the open report in place, with no banner (see Collaboration).
Risk tables are always sorted by severity (High, Medium, Low, Unspecified, No Risk). When a level changes inside the editor, the affected tables re-order and animate to their new position. When the same change comes from outside, the tables jump rather than animate, so the analyst notices that something shifted.
Cover page
The cover page is fully editable like any other content. The generator emits five role-tagged blocks the user can recognise on sight:
Eyebrow: small label above the title.
Hero: the report title (H1).
Stats: eyebrow-styled stat lines.
Date: eyebrow-styled date line.
Filters: eyebrow-styled summary of which filters were applied at generation time.
Cover-specific typography (Eyebrow size, Title size and weight, Subtitle size and weight, Title tracking) lives in Styling, Typography section. Toggling Eyebrow or Jumbo on a cover line in the toolbar correctly clears the cover-role overlay so the change round-trips through DOCX export.
Typical edits on the cover page include replacing the auto-generated title with the deal codename, updating the date format to match the firm's house style, and adding a confidentiality line below the stats block.
Images and image frames
Two ways to put an image on the page:
Inline image: toolbar Insert image button, opens a file picker (PNG, JPG, GIF, WebP, SVG). The image is uploaded to S3 and inserted at the cursor.
Image frame: toolbar Image frame button, drops a free-floating, draggable, resizable frame on the current page.
Once placed, an image frame supports:
Drag the body to move; the frame is clamped within page bounds.
Resize from the bottom-right handle. Hold Shift to lock the aspect ratio.
Double-click to re-upload.
A small floating toolbar appears above a selected frame with Upload image and Delete frame buttons.
Keyboard while selected: Backspace or Delete removes; Escape deselects; Cmd/Ctrl + D duplicates and selects the copy.
Inline images flow with the text and reflow on pagination. Image frames hold their absolute position on the page and are well suited to cover-page hero images, watermarks, or floating illustrations alongside text.
Pages
Insert blank page: toolbar button, adds a fully empty page after the current one.
Page break: toolbar button or Ctrl + Shift + Enter.
Page background: toolbar paint-bucket. Opens a popover where the user picks a page range (
fromtoto, or All), then a colour from a 16-swatch grid, native picker, or hex input. Apply, Cancel, or Clear.
Pagination is filter-aware: when filters hide content, page-break markers are hidden too, so the document never shows orphan empty pages.
Navigation
Outline sidebar
Hierarchical table of contents under the outline tab:
Areas at the top level (semibold).
Document types indented under each area.
Documents indented further (muted).
Each area and document-type row has a chevron to expand or collapse. Click a row label to scroll the editor to that section. As the user scrolls the document, the matching outline row highlights and its parents auto-expand.
Each area and document-type row also shows risk-count badges on the right (red for High, orange for Medium, yellow for Low). When risk-level filters are active, badges for muted levels are dimmed.
Document rows reveal a small file-icon button on hover that opens the document viewer for that file directly. This is the fastest path from the report to the source PDF when the analyst wants to verify a finding mid-edit.
Filtered-out entries appear at 40% opacity and are not clickable. Empty state: "No sections found".
Page counter and scroll
The toolbar shows a live page counter (e.g. 3 / 12) on the right. It updates as the user scrolls. There is no go-to-page input; use the outline or scroll directly.
Filters
The toolbar Filters button opens a popover with three multi-select sections:
Risk Level: High, Medium, Low. Each is preceded by its colour dot.
Areas: every area in the current report.
Recommendations: Pre-Closing, Closing Action, Post-Closing, Specific Indemnity, Specific Tax Indemnity, Representations & Warranties, No Action Needed.
Filters combine as AND across sections and OR within a section. For example, selecting High and Medium in Risk Level plus Corporate in Areas shows risks that are (High OR Medium) AND in the Corporate area, etc.
Active filters are reflected in:
The visible report (non-matching content hidden).
The outline (entries dimmed and unclickable).
Risk-count badges (muted levels grayscaled).
The DOCX or PDF export.
A Clear all link resets every filter. The Filters button shows a numbered badge when filters are active.
View risk in document
From the inline action menu on any risk row, View risk in document opens the document viewer on the risks tab with the matching risk pre-selected. This is the canonical way to jump from the report to the source evidence without losing the analyst's place in the report: closing the document viewer returns the analyst to the same scroll position in the editor.
Collaboration
The editor is real-time collaborative. Multiple analysts can edit the same report at the same time without explicit coordination.
Live presence
Other editors' carets appear in the document with a coloured pointer and a name label. Selections highlight in the editor's colour for that user. Each connected user gets a stable colour for the duration of the session.
When another user is editing a specific risk or document-recommendation cell, the surrounding table picks up a subtle indigo overlay treatment to indicate the row is locked, so a second editor doesn't overwrite their work mid-edit. The lock releases as soon as the first user moves their cursor out of the cell.
Cross-surface awareness
Presence carries across surfaces:
A risk being edited in the report editor is shown as "being edited" in the data room's risks tab and in the document viewer.
A risk being edited in the document viewer is shown as locked in the report editor.
The mapping today:
Field | Published from | Visible in |
Risk summary text | Report editor (cell selection) | Risks tab list, report editor lock overlay |
Document recommendation | Report editor (cell selection) | Doc viewer recommendations section, report editor lock overlay |
This prevents the classic split-screen scenario where two analysts overwrite each other while one is in the report and the other is in the document viewer.
Versionning
The versions tab in the sidebar lets analysts snapshot the document and restore it later. This is the right tool for milestone snapshots (e.g. "draft sent to client 8 May", "post-call revisions").
Save a version: type a name in the top input and click
+(or press Enter). The current state of the document is captured with the user's name and timestamp.List of versions: each row shows the version label, date, and author (e.g.
8 May, 14:32, Jane Doe).Restore: hover a row to reveal the rotate-counterclockwise icon. Clicking it rolls the document back to that version, disconnects the live session, clears the local cache, and reconnects.
A restore is destructive at the document level: it replaces the live document for everyone connected, not just the user who triggered it. There is no client-side offline cache to fall back on. Save a version before any operation you might want to undo broadly (a regenerate, a wholesale style change, a paste of new content).
Styling and templates
The toolbar Styling button (palette icon and label) opens the styling dialog. Changes apply live to the open document. The dialog has seven tabs.
The header strip indicates whether the report uses the organisation template or has been customised:
Style your report. Changes apply live.: using the template.
This report has custom styles different from your template.: overridden. A Reset to template action is available.
A Save as org template action becomes available when the report has been customised, letting the analyst promote the current style as the new organisation default (see Saving as the organisation template).
Stylign panel
A list of style presets. Each card shows the preset name in its own font, a tagline, and a six-swatch row (page background, text colour, High, Medium, Low, NoRisk).
Current presets:
Emma Standard (Arial baseline): the default, neutral and conservative, suitable for most M&A deliverables.
Slate: muted, professional, dark accents.
Atelier: serif-led, editorial feel for advisory firms with a literary brand.
Nocturne: dark page background variant for screen-first deliverables.
Terminal: monospaced, distinctive, well suited to tech-sector clients.
Applying a preset clears inline text-style marks first, so the new font and colours take effect across the whole document. The logo, footer text, and per-page background overrides are preserved.
Page setup
Paper size: A4 Portrait, A4 Landscape, Letter Portrait, Letter Landscape.
Margins: top, bottom, left, right (px, 0 to 200).
Typography
Font family: same selector as the toolbar (Sans Serif, Serif, Monospace, Display).
Body: Paragraph size, Line height, Paragraph spacing.
Headings: Area (H2), Doc type (H3), Document (H4), each in pt.
Cover: Eyebrow size, Title size, Subtitle size; Title weight, Subtitle weight; Title tracking (em).
A Reset sizes link appears when typography is dirty.
Colors
Risk colours: High, Medium, Low, Unspecified, No Risk.
Recommendations: recommendation accent colour.
Document defaults: text colour and page background.
Tables
Border colour and Header background for risk tables.
Risk table column split: slider 20 to 80%, controls how much horizontal space is given to descriptions vs recommendations. Live caption updates as the slider moves.
Risk indicator: four modes.
Side border: coloured edge along the row.
Coloured dot: small dot in the leading column.
Coloured label: uppercase prefix in the header (HIGH, MEDIUM, LOW).
None: no visual indicator beyond the table's section grouping.
All four modes are mirrored in DOCX export.
Logo
Image: drop-or-click to upload a PNG, JPG, or WebP. Action label "Drop or click to replace". When using the default Emma logo: "Using Emma (default)".
Position: left, centre, right.
Size: 8 to 48 pt slider with live label.
Remove: appears when a custom logo is set, reverts to the default Emma logo.
Header and footer
Show area and document type in page header: checkbox.
Show page numbers: checkbox.
Footer text: free text, e.g. "Confidential".
Header and footer colour: colour picker with reset link when overridden.
Per-page background
Page-by-page background overrides come from the toolbar paint-bucket (see Pages), not the styling dialog. The default page background lives in Colors. The split is intentional: per-page overrides are a layout decision (typically applied to a single cover or divider page), while the document default is a style decision (applies everywhere by default).
Saving as the organisation template
The Save as org template action in the styling dialog header copies the current report's settings (typography, colours, table style, header and footer, logo, and so on) and stores them as the organisation's default. New reports generated after that point inherit the new template; existing reports keep whatever settings they were saved with.
This is the right path when one analyst has tuned a report to the firm's house style and the team wants future reports to start from the same baseline.
Export
The toolbar Export button is a dropdown with two options:
Export DOCX: downloads
report.docxwith the full visual fidelity of the editor (typography, page setup, page backgrounds, header and footer, risk colours, table risk-indicator mode, logo, and any embedded images). Charts present in the editor are captured and embedded.
Export PDF: same pipeline through the DOCX serializer, then converted to PDF.
Active filters are honored by the export (filtered-out content is excluded), as is the current pagination layout. To export a "full" report regardless of filters, clear the filters before exporting.
The button shows a spinner and a label like "Exporting DOCX…" or "Exporting PDF…" while the export runs, and is disabled until it completes.
Keyboard shortcuts
Action | Shortcut |
Bold | Ctrl / Cmd + B |
Italic | Ctrl / Cmd + I |
Underline | Ctrl / Cmd + U |
Page break | Ctrl + Shift + Enter |
Undo | Ctrl / Cmd + Z |
Redo | Ctrl / Cmd + Shift + Z |
Resize image frame proportionally | Hold Shift while dragging the handle |
Duplicate selected image frame | Ctrl / Cmd + D |
Delete selected image frame | Backspace or Delete |
Deselect image frame | Escape |
Navigate editable nodes | Tab |
Loading and recovery
Initial load: full skeleton (toolbar, sidebar, three A4 placeholders) until the live session syncs.
Regenerate: triggered by the stale-data banner or the dev-only Regenerate toolbar action; rebuilds the document and reconnects.
Restore version: wipes local state and reconnects to the restored document; visible to every connected client.
Connection drop: the editor reconnects automatically when the server is reachable. Local edits made while offline are merged through the CRDT layer once the connection is back. The user is not blocked from typing during a brief disconnect.
Common workflows
A handful of recurring flows worth documenting end to end.
Drafting a first deliverable
Open the report from the data room's Report tab. Wait for the initial generation to complete.
Edit the cover page: update the title, the date, and the confidentiality line.
Open Styling, pick the preset that matches the deliverable's audience (Slate for institutional, Atelier for boutique advisory, and so on).
Skim the outline; expand each area and review the risk tables. Use View risk in document to verify any finding that's been edited since generation.
Adjust risk levels and recommendations inline using the action menu.
Save a version named "v1 internal review" before sharing the draft.
Export DOCX.
Filtering for a focused export
Open Filters from the toolbar.
Select the risk levels and areas relevant to the audience (e.g. High and Medium only, Corporate and Tax only).
Verify the resulting outline and pagination match the intended scope.
Export DOCX or PDF. Filtered-out content is excluded from the file.
Clear filters once the export is done so the next user opens an unfiltered view.
Collaborating live
Two or more analysts open the same report. Each sees the others' carets with a coloured label.
Decide informally who edits which area to avoid contention; the lock overlay will warn of any overlap.
Use the outline to keep track of where colleagues are working.
Save a version at the end of each session as a checkpoint.
Reacting to data drift
An amber stale-data banner appears: a new risk has been added or an existing one was deleted at the data-room level.
If the in-progress narrative is light (cover page tweaks, minor edits), click Regenerate.
If the narrative is heavy (custom introductions, image frames, restructured sections), save a version first, then regenerate, then port any missing free content from the saved version back into the regenerated document.
If the change is irrelevant to the current deliverable, Dismiss the banner. The report continues against the older snapshot.











