Documentation

Document templates

Document templates are reusable starting points for the documents your firm creates over and over: engagement letters, retainer agreements, intake summaries, demand letters, and more. Build a template once, then spin up a fresh, fully editable copy whenever you need one, so you never start from a blank page or copy and paste from an old matter.

This page explains what templates are, where to find them, how to create a new document from a template, and how to turn any document into a template (or remove the template flag). Fillable PDFs set up as PDF forms, including USCIS forms from the Esqase form library, are listed on the same Templates page.

Before you begin

  • Templates live alongside your regular files in the Documents workspace. If you are new to that area, see The documents workspace.
  • Templates are native rich-text documents (the kind you edit in the built-in editor), not uploaded files. You cannot mark an uploaded PDF or Word file as a template. To reuse a fillable PDF, such as a USCIS form, for every client, set it up as a PDF form instead. See Filling PDF forms such as USCIS forms.
  • What you can do depends on your role and your firm's permissions for documents:
    • To view the templates list, you need View access for documents.
    • To create a template or create a document from one, you need Create access.
    • To mark, unmark, or change the status of a template, you need Update access.
    • To upload a PDF form, you need Create access for documents and Update access for both forms and documents. To archive or restore a PDF form, you need Update access for both forms and documents. To fill one for a record, you need Create and Update access for documents and View access for forms.
    • Firm owners can do all of the above. If your role does not include the access a step needs, you will not see the button described in that step.

Note: Templates are shared across your whole firm. A template you create is available to every member who can create documents, so give it a clear, descriptive name.

What document templates are

A template is simply a document that has been flagged as a template. That flag does two things:

  • It collects the document on the dedicated Templates page so it is easy to find and manage, separate from your day-to-day files.
  • It makes the document available as a starting point in the Template picker when you create a new document. Choosing it copies the template's content, tabs, header and footer, and page setup into a brand-new document.

A few things to keep in mind:

  • Creating from a template makes a copy. The new document is independent. Editing it never changes the template, and updating the template never changes documents you already created from it.
  • Templates have a status, just like regular documents: Draft, Active, or Archive. Only Active templates appear in the Template picker when you start a new document, so a template is not offered to your team until you set it to Active.
  • Templates are firm-shared. They are stored in a system Templates folder (with a Documents subfolder) that Esqase manages for you. You do not need to create or maintain that folder yourself.
The Document templates page showing the templates list with the Name, Owner, Status, and Last updated columns, and the All / Draft / Active / Archive status

Browse template folders

There are two ways to find your templates: the dedicated Templates page (best for managing them) and the Templates folder inside the main documents tree.

Open the Templates page

This is the fastest way to see every template in one place.

  1. In the sidebar, click Documents.
  2. In the page header, click Manage templates. (You will only see this button if you have View access for documents. On a phone, it is in the More document options menu, the ... button.)
  3. The Templates page opens, listing your firm's document templates and PDF forms in one list.

The header has New template and Upload PDF form (see Upload a PDF form). While the Form library is on, firm owners and members whose role can update Matter settings also see a ... button after them with Sync Form library, which adds any USCIS forms your firm is missing and brings back ones that were archived or moved to Trash. See The USCIS form library. On a phone, Upload PDF form and Sync Form library are in the More template options menu (the ... button).

On this page you can:

  • Filter by status using the tabs at the top of the table: All, Draft, Active, and Archived. The list opens on Active by default. PDF forms are never drafts: they are Active or Archived.
  • Search using the Search templates box. It matches the name, the description, and a PDF form's code such as I-130. Capitals do not matter.
  • Filter by Owners and by Type. Click Clear filters to reset the search and filters.
  • Sort by clicking the Name, Type, Status, Size, or Last updated column headers. Until you choose, the list is in Type order (document templates, then PDF forms, then USCIS forms), and by name within each type.
  • See, for each row, its Name, Type (Document, PDF form, or USCIS form), Edition, Status, Size, Owner (the member who created it), and Last updated time. Edition shows the edition of a PDF form, such as 04/01/24, or 04/01/24 (revision 2) for a USCIS form edition Esqase improved, and a dash for other rows.

When nothing matches, the page says so: No templates yet on All, No active templates on Active (each with New template and Upload PDF form when your role allows them), No draft templates or No archived templates on the other tabs, and No matches with Clear filters after a search or filter.

Tip: To get back to the main file list at any time, click Documents in the breadcrumb above the page title.

The Documents page header with the Manage templates button highlighted, next to the New button.

Find templates in the documents tree

Templates also live in a managed folder structure inside the regular Documents workspace, which is handy when you are already browsing files.

  1. In the sidebar, click Documents.
  2. Open the Templates folder, then the Documents subfolder inside it.
  3. Your template documents are listed there.

PDF forms you upload from the Templates page go to a PDF forms folder inside Templates unless you choose another folder. USCIS forms from the Esqase form library go to Templates > Form library unless your firm chose another masters folder.

Important: The Templates folder and its Documents subfolder are system folders that Esqase maintains automatically. Do not rename, move, or delete them. Doing so can break the templates feature, and the option to rename or move them is intentionally not offered.

Create a document from a template

When you create a new rich-text document, you can start from a blank page or copy an existing template. Starting from a template brings over the template's content, tabs, header and footer, and page setup so you only have to fill in the specifics.

  1. In the sidebar, click Documents.
  2. (Optional) Open the folder where you want the new document to live. The new document is created in the folder you are currently viewing.
  3. In the page header, click New, then click New document.
  4. In the New document dialog, type a Document name. This is required. You can rename the document later.
  5. Open the Template picker. Start typing to filter the list by name, or scroll to find your template.
    • The list always starts with Blank document, which creates an empty document.
    • Below that are your firm's Active templates. Draft and archived templates do not appear here.
    • If your role can fill PDF forms, the list ends with the active PDF forms that have fields, marked (PDF form) or (USCIS form). Picking one turns the dialog into Fill for a record. See Fill a PDF form for a record.
  6. Choose the template you want (or leave Blank document selected to start empty).
  7. Click Create document.

When you click Create document, Esqase creates a new document, copies the selected template's content, tabs, header and footer, and page setup into it, and opens it in the editor so you can start editing right away. The original template is untouched. If you create the document in a matter's documents, Esqase also fills its placeholders from that matter as it creates it. See Placeholders in templates. A template with a signature preset also gives the new document its signers and fields. See Signature preset.

  • Required field: Document name must not be empty. If you leave it blank, you will see "Please enter a document name."
  • Default: the Template picker defaults to Blank document, so if you do nothing you get an empty document.
  • If you do not see the New button at all, your role does not include Create access for documents.
The New document dialog with a Document name filled in and the Template picker open, showing Blank document at the top followed by a list of active templates.

Tip: The helper text under the picker says "Start blank or copy the content and page setup from a template." Page setup means things like page size and orientation, so a template's layout carries over too, not just its text. So do its tabs, its header and footer, and its page numbers. See Headers, footers, and tabs in templates.

Common questions

  • Will editing my new document change the template? No. The new document is a separate copy. Your edits stay in the new document.
  • My template is not in the picker. Why? Only Active templates appear. Open the template on the Templates page and set its status to Active (see below). Also confirm the document is actually flagged as a template.
  • Can I start from a template inside a matter? Yes. The same New document flow is available from a matter's Documents tab, and the Template picker works the same way there. A document you create there opens with its placeholders filled from the matter.

Mark and unmark a document as a template

You can promote any rich-text document into a template, and you can remove the template flag later. You can also create a brand-new, empty template from scratch.

Mark an existing document as a template

Use this when you have already written a document (for example, a polished engagement letter on a real matter) that you want to reuse.

  1. Open the document. You can do this from the Documents workspace or from a matter's Documents tab.
  2. In the document editor toolbar, click the template button (the layout-template icon). Hover over it to confirm it reads Mark as template.
    • You can also do this without opening the document: in the file list, click the More actions (three-dots) menu on the document's row, then click Mark as template.
  3. Esqase flags the document as a template. The icon fills in to show it is now a template, and you will see a "Marked as template" confirmation.

Once marked, the document appears on the Templates page. Remember to set it to Active if you want it offered in the Template picker.

Marking a document as a template also clears the placeholder values it took from its record, so the template never holds one client's details. See Mark as template clears record values.

Note: The Mark as template option only appears for native rich-text documents, not for uploaded files or folders, and only if you have Update access for documents.

The document editor toolbar with the Mark as template button highlighted (the layout-template icon), shown in its unfilled state.

Create a new template from scratch

Use this when you want to build a template fresh rather than promote an existing document.

  1. In the sidebar, click Documents.
  2. In the page header, click Manage templates.
  3. On the Templates page, click New template.
  4. Esqase creates a template named Untitled template and opens it in the editor. Rename it and add your content.

The new template is created in your firm's managed Templates folder automatically. Set its status to Active when it is ready to be used (see "Change a template's status" below).

Note: You will only see the New template button if you have Create access for documents.

Unmark (remove the template flag)

Removing the template flag turns a template back into a regular document. The document and all its content are kept; it just stops being offered as a template.

  1. Go to the Templates page (sidebar Documents > Manage templates).
  2. On the template's row, click Open to open it, or use the row's More template actions (three-dots) menu.
  3. To remove the flag from the open document, click the template button in the editor toolbar (it now reads Remove template). To remove it from the list, click Remove template in the row's menu.
  4. Confirm if prompted. The document is no longer a template, but the document itself remains in your files.

You can remove the template flag from several templates at once: on the Templates page, select the checkboxes for the rows you want, then choose Remove template from the batch actions. You are asked to confirm, and Esqase reminds you that "The documents themselves are kept."

Important: Removing the template flag does not delete anything. It simply takes the document off the templates list and out of the Template picker. To actually remove a document, trash it from the Documents workspace instead.

The Document templates page with a row's three-dots menu open, showing Share, Set to active / Set to draft, Archive, and Remove template options.

Change a template's status

A template's status controls whether it is offered when starting a new document. Only Active templates appear in the Template picker.

  1. On the Templates page, open the template's row menu (three dots) or use the editor toolbar.
  2. Choose the status you want:
    • Set to active makes the template available in the Template picker.
    • Set to draft hides it from the picker while you keep working on it.
    • Archive moves it to the Archived tab and out of the picker, without deleting it. You can restore it later by setting it back to Draft or Active.
  3. The change saves immediately and a confirmation appears.

You can also change status for several templates at once. Select the rows with their checkboxes, then use the batch actions Set to active, Set to draft, or Archive. Archive asks you to confirm in Archive selected templates?. Selected PDF forms take Set to active, which restores an archived one, and Archive. Set to draft and Remove template apply to document templates only.

Tip: Use Draft for templates you are still writing, Active for ones the team should use, and Archive for retired ones you might want back later.

PDF forms on the Templates page

A fillable PDF set up as a PDF form is listed on the Templates page with the Type PDF form, or USCIS form for one from the Esqase form library. Old links to the PDF forms tab of Forms open this page with the list narrowed to PDF forms and USCIS forms.

  • Open opens the PDF form on its Fields tab. Closing it brings you back to Templates.
  • The row's More PDF form actions menu (the ... button) offers:
    • Fill for a record, on an active PDF form that has fields, to fill a copy for a matter or lead. See Fill a PDF form for a record.
    • Archive, which asks "Archive this PDF form?": "The PDF stays in Documents and its filled copies stay as they are. Restore it to use it again." Click Archive, and you see PDF form archived.
    • Restore, on an archived PDF form, to make it active again.

On a USCIS form, the Archive confirmation adds "While the Form library is on, Esqase brings this USCIS form back.", and so does the batch Archive when the selected rows include one. See The USCIS form library.

Upload a PDF form

Upload a blank fillable PDF and set it up as a PDF form in one step.

  1. On the Templates page, click Upload PDF form (on a phone, open More template options first).
  2. In the Upload PDF form dialog, "Choose a fillable PDF up to 50 MB. Its fields open next, ready to map." Drag the PDF onto the box, or click it to choose the file. You can upload one PDF at a time.
  3. Check Save to. It starts on Templates / PDF forms, a folder Esqase creates the first time it is used. Click Change folder to pick another.
  4. Click Upload. The dialog shows Preparing the upload, then Uploading with the percentage done, then Reading the PDF fields. While the file is uploading, Cancel upload stops it.
  5. You see PDF form set up, and the PDF form opens on its Fields tab, ready to map. See Set up a PDF form.

Before uploading, the dialog refuses a file that is not a PDF ("Choose a PDF file"), an empty file ("This file is empty. Choose a PDF with content"), and a PDF over 50 MB ("This PDF is larger than 50 MB. Choose a smaller file"). When Esqase uploads the PDF but cannot set it up, for example because it needs a password, only works in Adobe Reader, has more than 2,000 fields, or cannot be read, the dialog says why and where the file was saved, such as "The file is saved in Templates / PDF forms." See PDFs that cannot be set up.

Placeholders in templates

A template is where you write placeholders once, so every document made from it fills itself in. Write {{contact_name}}, {{matter_number}}, or {{damages_total}} into the template, and each document you create from it carries that client's and that case's details. See Document placeholders.

  • The template keeps its tokens. Record placeholders such as {{contact_name}} or {{matter_title}} stay empty on the template itself. The Placeholders panel says so: "Templates fill firm, member, date and document fields only. Record fields fill when a document is created from this template."
  • Each document fills from its own record. Create a document from the template in a matter's documents, or let a workflow Document step create it, and its placeholders fill from that matter or lead: the client, the matter, the court, invoices, events, custom fields, personal injury figures, and form answers. (A document a workflow creates on its own leaves the court, invoice, event, and personal injury ones for the member who reviews it, unless a form answer fills them.) A template never carries one client's values into another client's document.
  • Firm and member defaults carry over. A value you type on the template for a firm or member placeholder, or for one of your own placeholders such as {{retainer_terms}}, becomes the starting value in every document made from it. In the new document, the row offers Use record value (or Use my details on a member placeholder) when the record holds something different.
  • Insert form questions with Show answers from. In Insert a field, open Form answers and pick a form in Show answers from to insert its questions. They stay empty on the template and fill from that form's answers in each document.
  • Exports keep the tokens. Downloading a template as a PDF or Word file, printing it, or making a signing copy keeps its {{tokens}}, and Esqase does not warn about empty placeholders on a template.
  • Placeholders in tabs, headers, and footers. Placeholders in every tab and in the header and footer fill from the new document's record when the document is created. See Placeholders in tabs, headers, and footers.

Mark as template clears record values

When you mark a document as a template, Esqase clears every placeholder value that came from a record, so a template never holds a client's details. That covers contact, matter, lead, court, invoice, event, personal injury, custom field, and form answer values, as well as the date and the document's own name and creation date. Values Esqase filled in automatically are cleared too, including firm and member ones.

Values someone typed for firm and member placeholders, and for your own placeholders, stay on the template as its defaults. To fill the firm, member, date, and document placeholders on the template again, click Fill from records in its Placeholders panel.

Removing the template flag leaves the values as they are.

Headers, footers, and tabs in templates

A template carries its whole layout, so a letterhead or a set of schedules is built once and reused in every document made from it.

  • Header and footer. A logo, the firm's name and address, and page numbers in the template's header and footer appear in every document created from it, together with the header and footer margins, Different first page, and the page numbers' Start at. See Headers, footers and page numbers.
  • Tabs. Every tab of the template is copied, with its name and order, including the first tab's name. See Document tabs.
  • Layout. A template in the Pageless layout creates Pageless documents.
  • Every way of creating. The New document dialog, a workflow Document step, and the AI Assistant all copy the same parts when they create a document from a template.

Tip: To build a letterhead template, create a template, open its header, add the logo and the firm's details, then set the template to Active. See Add a logo or letterhead.

Signature preset

A template can carry a signature preset: the signers and signature fields every document made from it starts with, such as the client's signature line on an engagement letter.

  1. Open the template on a wide screen and click Signature preset in the header, beside Sign. On a narrower window, open More actions and choose Signature preset.
  2. The Signature preset dialog shows the template's pages with the line "Documents made from this template start with these signers and fields."
  3. Add the signers, for example the Primary client placeholder, place their fields on the pages, and click Save. You see Preset saved.

Every document you then create from the template starts with the preset. Click Sign on that document and its PDF copy opens on Signatures with the signers and fields already placed. The button appears for members with Update access for documents. See Signature presets.

Copies go to

A template's Details tab, in the editor's side panel, has a Copies go to row: the folder where documents a workflow Document step makes from this template are saved. Until you choose one it reads Matter or lead folder (default), and those documents go to the matter's or lead's own folder.

  1. Open the template and, in the side panel, open the Details tab.
  2. Next to Copies go to, click Change.
  3. In Choose a folder, go to the folder you want and click Select this folder.

You see Copies folder changed, and the row shows the folder's path. The folder you choose comes before the matter's or lead's own folder. To go back to the default, click Clear (Copies folder cleared). Changing it needs Update access for documents.

Note: A document you create yourself from the New document dialog still goes to the folder you are viewing. See Default document locations for every place Esqase saves new files.