Upload an engagement template

Import an existing engagement letter document and convert it into a reusable template with merge variables.

Last reviewed

How it works

If you already have engagement letter templates as DOCX or PDF files, you can upload them to the platform and have them automatically parsed into editable, reusable templates. Uploading is part of creating a custom template, so it needs a plan that includes custom templates. Before you choose a file, tick the box to confirm that you or your firm own the document or have permission to use it for your clients. Behind the scenes, reading the file has two stages:

  1. Instant parsing: Your document is analysed immediately. Sections are detected from heading styles or bold titles in a DOCX, or from capitalised and numbered headings in a PDF. Explicit merge variables (e.g. {{client_name}}) are recognised automatically.
  2. AI-assisted scanning: After the initial parse, our AI scans the text for implicit placeholders such as names, dates, fees, and addresses. You can accept or dismiss each suggestion individually.

Screenshot, for illustration only

The Engagement Letter Templates page listing the practice's templates by category, with the platform default template and a custom templateThe Engagement Letter Templates page listing the practice's templates by category, with the platform default template and a custom template
The Engagement Letter Templates page listing the practice's templates by category, with the platform default template and a custom templateThe Engagement Letter Templates page listing the practice's templates by category, with the platform default template and a custom template
Engagement letter templates, where Create template starts a custom template and the upload. Without a plan that includes custom templates, a note says so.

Supported file formats

Accepted formats

  • DOCX: Microsoft Word documents (.docx). This is the recommended format as headings and bold text are preserved, giving the best section detection.
  • PDF: Portable Document Format (.pdf). Text is extracted and sections are detected using capitalised headings and numbered paragraphs.

Best results

For the most accurate parsing, use a DOCX file with properly formatted heading styles (Heading 1, Heading 2) for each section title. The parser uses these styles to split your document into distinct sections.

Unsupported formats

  • .doc files (legacy Word format): Please save as .docx in Microsoft Word before uploading.
  • Scanned PDFs (image-only): The parser extracts text content; scanned images without embedded text cannot be processed.

If a PDF is password-protected, the page asks for the password and opens the file once you enter it.

The maximum file size is 10 MB. If your document exceeds this limit, consider removing large images or embedded objects before uploading.

Formatting tips for better results

The parser uses a three-tier detection strategy for identifying sections in your document. Following these guidelines will produce the best results:

DOCX documents

  1. Use heading styles: Apply "Heading 1" or "Heading 2" styles to section titles (e.g. "Scope of Services", "Fees and Payment"). This produces the most reliable parsing.
  2. Bold fallback: If your document does not use heading styles, making section titles bold will allow the parser to detect them as section boundaries.
  3. Single section fallback: If neither heading styles nor bold titles are found, the entire document is imported as a single section that you can manually split later.

PDF documents

  1. Capitalised headings: ALL CAPS lines (e.g. "TERMS OF ENGAGEMENT") are treated as section boundaries.
  2. Numbered sections: Lines starting with a number (e.g. "1. Scope of Work" or "2.1 Fees") are detected as section headings.
  3. Roman numerals and capital letters: Lines starting with a Roman numeral or a single capital letter, followed by a capitalised title (e.g. "IV. Fees", "A. Payment") are detected too.

Sample template

Download our sample engagement letter template to see the recommended formatting in practice. It includes properly styled headings, common merge variables, and standard engagement letter sections.

Download sample template (.docx)

Merge variables

What are merge variables?

Merge variables are placeholders in your template that are automatically replaced with real data when sending an engagement letter to a client. For example, {{client_name}} is replaced with the client’s actual name.

Supported variable syntax

The parser recognises several common placeholder formats used in legal document templates:

  • Double curly braces: {{variable_name}} (recommended)
  • Double square brackets: [[variable_name]]
  • Angle brackets: <<VARIABLE_NAME>>
  • Capitalised bracket text: [Client Name],[Client Address]
  • INSERT directives: [INSERT FULL NAME HERE]

All detected variables are automatically normalised to the standard{{snake_case}} format and mapped to recognised canonical names where possible (e.g. "solicitor_name" becomes "professional_name").

Common merge variables

  • {{client_name}}: The client’s full name
  • {{client_email}}: The client’s email address
  • {{professional_name}}: Your name as the legal professional
  • {{firm_name}}: Your firm or practice name
  • {{fee_amount}}: The quoted fee for services
  • {{fee_currency}}: The currency for the fee
  • {{service_description}}: Description of the services to be provided
  • {{start_date}}: The commencement date for services
  • {{trading_name}}: Your trading name
  • {{regulatory_body}}: The regulatory authority name
  • {{licence_number}}: Your professional licence number
  • {{jurisdiction}}: The governing jurisdiction
  • {{date_today}}: The date the letter is generated

Custom variables

You can use any variable name you like. Variables that don’t match a recognised canonical name are kept as-is in snake_case format. Only variables the platform can resolve from your profile and the matter are filled in automatically; anything else is left in the letter for you to complete before you send it.

AI-suggested variables

After your document is parsed, our AI automatically scans the text for values that look like they should be merge variables: names, dates, monetary amounts, addresses, and other client-specific data.

How AI suggestions work

  1. The AI reads each section of your parsed template and identifies text that appears to be placeholder data (e.g. "John Smith" as a client name, or "£500" as a fee).
  2. Each suggestion shows the original text, the suggested variable name, the reason, and a confidence level (high, medium or low).
  3. Click the tick (Accept variable) to replace the original text with the merge variable, or the cross (Dismiss suggestion) to keep the text as-is.

AI availability

AI suggestions are processed by our self-hosted AI service. If the service is temporarily unavailable, your template will still be parsed normally, and you simply will not receive AI suggestions. You can always add merge variables manually by editing the section text.

Step-by-step upload guide

  1. Open Engagement templates from the Templates group in the sidebar, open the menu beside Create template and choose Import from a document. The import page walks you through three steps.
  2. Upload: tick the box to confirm you may use the document, then drag and drop your DOCX or PDF file onto the upload area, or click to browse for it. If the file is password-protected, the page asks for the password. Open How to prepare your file for the formatting tips.
  3. Check: your document is parsed straight away. Review the detected sections, each with a title and body you can edit. While you review, the AI scans for more merge variables; accept or dismiss each suggestion. Click Continue when the sections look right.
  4. Name and save: give the template a name (pre-filled from the file name), choose the jurisdictions, the service category and the consent declarations, then click Save template. The template opens, ready to use when you send engagement letters to clients.

Frequently asked questions

Can I edit sections after uploading?

Yes. After uploading, every section title and body is fully editable. You can rewrite text and add or remove merge variables before saving the template. Once it is saved, you can also add, delete and reorder sections from the template detail page.

What happens if my document has no headings?

If the parser cannot detect section boundaries (no heading styles, bold text, or numbered sections), the entire document is imported as a single section. After saving, you can add further sections on the template detail page and move text between them.

Are tables preserved during parsing?

Partly. Tables in DOCX files are extracted as plain text, with cells separated by a vertical bar, and added as a separate Tables section at the end rather than where they sat in the document. Merge variables inside table cells are also detected.

Can I upload the same document multiple times?

Yes. Nothing is saved until you click Create template, so you can create several templates from the same base document and customise each independently.

What if the AI suggests an incorrect variable?

Simply dismiss (Dismiss suggestion) any suggestion you disagree with. AI suggestions are never applied automatically, so you have full control over which changes are made to your template.

Can’t find what you’re looking for?

Our support team is here to help. Contact us and we’ll get back to you as soon as possible.

Contact us

We use cookies to improve your experience. See our Cookie policy (opens in a new tab) for details.