Files
Reactive-Resume/docs/guides/adding-a-cover-letter.mdx
T
Amruth Pillai 2506509538 feat: make cover letters documents of their own
Resumes no longer hold cover-letter sections. A migration saves every
letter a resume carried as a letter linked to that resume's details and
design, hands a resume's only letter to its only letter-less application,
then removes the sections from resumes and their layouts. rollback.sql
puts them back.

Every resume write on the server moves any letter it still carries into
a saved letter in the same transaction, so stale tabs, older files, API
clients and restored versions keep working without duplicating letters.

The resume editor no longer adds or imports letters, the resume download
drops its Cover letter tab, and resume PDF downloads (API, signed links,
MCP) no longer take a cover-letter target. copy_embedded_cover_letter and
POST /cover-letters/from-resume are removed.
2026-09-29 09:30:07 +02:00

65 lines
3.2 KiB
Plaintext

---
title: "Adding a cover letter"
description: "Write a cover letter in Reactive Resume as a document of its own, match it to your resume's design, attach it to a job application, and export it."
---
A cover letter goes alongside your resume when you apply for a job. In Reactive Resume a cover letter is a document of its own, next to your resumes in **Documents**. It is not a section inside a resume.
## Create a cover letter
<Steps>
<Step title="Open New">
In **Documents**, click **New**, then **New cover letter instead**.
</Step>
<Step title="Pick who it's from">
Under **From**, choose the resume the letter goes with. The letter uses that resume's name, contact details and design, and follows them when you change the resume.
</Step>
<Step title="Pick who it's for">
Under **For**, link the job application the letter is for. The recipient fills in from the application, and the application lists the letter as the one you sent.
</Step>
<Step title="Write">
Write the body. The greeting and sign-off follow the recipient's name and your name.
</Step>
</Steps>
You can also start a letter from an application: open it in **Applications** and click **Write a letter** under **What you sent**.
## Match your resume, or design it on its own
By default a letter matches its resume's template, type and colors. Turn off **Match** in the letter's **Design** mode to give it a template, type, colors and page settings of its own.
## Attach a letter to an application
A letter linked to an application under **For** is that application's letter. Each application has one letter; linking a letter to another application moves it there. When the application reaches **Applied**, the letter is saved in its History as the version you sent.
## Export a letter
Open the letter and click **Share & export**, then **Download**, and pick PDF or DOCX. When you download a resume whose application has a letter, the resume's **Download** tab offers to include the letter as a second file.
## Letters written inside a resume
Older versions of Reactive Resume let you add a cover letter as a section of a resume. Those letters have moved to **Documents**:
- Each one is a letter of its own, named after its resume and section, for example "Frontend Resume — Cover Letter".
- It stays linked to that resume's details and design, so it looks as it did.
- If the resume was used by one application that had no letter, the letter is attached to that application.
- The resume no longer contains the letter. Older versions of the resume in its History still do; restoring one saves those letters again as letters.
Importing a resume file that contains cover letters, or sending one through the API, does the same: the letters are saved as letters and the resume keeps none.
## Tips for effective cover letters
<Tip>**Keep it concise**: Aim for 250-400 words. Recruiters spend about one minute reading cover letters.</Tip>
<Tip>
**Tailor each letter**: Write one letter per application. Reference specific job requirements and company values.
</Tip>
<Tip>
**Proofread carefully**: Spelling and grammar errors can disqualify your application. Review your letter before
exporting.
</Tip>