> For the complete documentation index, see [llms.txt](https://help.tahua.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.tahua.io/product-news/2026/july/converted-multiple-assessor-applicant-and-verifier-emails-to-previewable.md).

# Converted multiple Assessor, Applicant, and Verifier emails to Previewable

## Problem

Most system emails could only be previewed with generic placeholder values — admins had no way to see what an email would look like with real data. This made it difficult to verify that custom wording, personalisation variables, and dynamic form-field values would render correctly before the email was sent to a recipient.

## How It Works

### Previewable emails

Each email can declare which records it needs for a meaningful preview. When an admin opens the preview for one of these emails, a **Select Preview Data** modal appears, prompting them to pick the relevant records (e.g. a specific application, verifier, assessor, or contract). The email is then rendered with real values pulled from those records.

### Select Preview Data modal

The modal shows a description explaining what kind of data to select, followed by a Select2 search field for each required record type. Labels use organisation-specific terminology (e.g. the org's custom term for "Verifier" or "Application").

After selecting records and clicking **Preview**, the email renders in a new tab using the chosen data.

### "Previewing with data from" banner

When viewing a preview that was generated with real records, an info banner appears at the top of the preview page listing which records were used. Each record name is a link to that record's admin page (subject to the admin's read permissions).

### Shareable preview URLs

The record IDs selected in the modal are appended to the preview URL as query parameters. This means a preview link can be copied and shared with other admins, who will see the same email rendered with the same data (using the current saved email content rather than any unsaved draft).

Draft content (unsaved edits to the email subject or body) is still included when previewing via the modal — it is sent as POST body data so it does not appear in the URL.

## Emails Converted

The following emails were converted to support data-driven preview:

**Assessor emails** (`FundingSystem::AssessorMailer`)

* Assigned Applications — selects an assessor and assessment round
* Unclaimed Assessor Assigned Applications — selects an assessor and assessment round

**Contract emails** (`FundingSystem::ContractsMailer`)

* Contract Offer — selects a contract
* Contract Offer (New Applicant) — selects a contract
* Contract Offer (New Verifier) — selects a contract
* Admin Contract Signing — selects a contract

**Registered Provider (Applicant) emails** (`FsRegisteredProviderMailer`)

* On Submission — selects a funding application
* Funding Application Submission — selects a funding application
* On Milestone Approved — selects a milestone
* On Milestone Paid — selects a milestone

**Verifier emails** (`VerifierMailer`)

* Application Assigned — selects a verifier and funding application
* Application Submitted — selects a verifier and funding application
* Offer Notification — selects a verifier and funding application
* Milestone Submitted — selects a verifier and milestone
