Documentation

Converting a lead to a matter

A lead is a prospective client you are still deciding whether to take on. A matter is an active case you are working. Converting a lead to a matter is the moment a prospect officially becomes a client: Esqase creates a new matter from the lead's details, marks the lead as hired, and links the two together so nothing has to be re-typed.

This page explains when to convert, the two ways conversion can happen (a quick template-based conversion or the full new-matter form), what information and records carry over, how the small invoicing matter of a lead you already billed folds into the new matter, what changes about the lead afterward, and how a workflow can convert leads for you automatically.

Before you begin

  • You need a lead. Conversion starts from an existing lead. To create or work with leads, see Managing leads.
  • From the header, the lead must be hired first. The Convert to matter button in the lead's header only appears on a lead that has been marked as hired. If the lead is still in your intake pipeline, mark it Mark as hired first. (The workflow-item path below is the exception: a Convert to matter or Invoice workflow item can convert whether or not the lead is hired, and marks it hired for you.)
  • You need permission to create matters. Conversion creates a new matter. If your role does not include create access for matters, the new-matter form will show a no-access message and the conversion cannot complete. Firm owners, administrators, and attorneys can create matters by default; staff roles are view-only for matters unless your firm has changed that. See Roles and permissions.
  • A practice area helps. Conversion places the new matter into a practice area and a pipeline stage. If you convert with a matter template, the template supplies the practice area; otherwise you choose one in the form. See Practice areas and stages.
The lead detail page for a hired lead, with the Convert to matter button highlighted in the header action bar.

When to convert a lead

Convert a lead once you have decided to represent the client and you are ready to start doing the work. Until then, keep the prospect as a lead so you can track it through your intake pipeline, run conflict checks, and gather information without cluttering your active caseload.

A few signals that it is time to convert:

  • The client has agreed to engage your firm.
  • You are ready to begin tracking tasks, time, documents, and billing against the case.

Screen the lead for conflicts before you take the case on. Mark as hired runs a conflict check on the lead's contact and holds the lead until you acknowledge any high-priority matches, or acknowledge that the check could not be completed. You can also run one any time from Conflict check in the lead's ... menu, or with a Conflict check step in its workflow. The convert dialog itself does not run a check. Reviewing the results and deciding whether a conflict exists stays with you. See Running a conflict check.

Tip: You do not have to convert immediately. You can mark a lead as hired to record the outcome, finish any intake steps, and convert later. A hired lead that is not converted yet can still be returned to intake, marked not hired, or converted whenever you are ready.

Convert a lead to a matter

There are two paths to conversion, and Esqase chooses between them for you based on whether you pick a matter template. Both start the same way.

  1. Open the lead from your intake pipeline. In the sidebar, click Intake, then open the Leads area and click the lead you want to convert.
  2. If the lead is not already hired, click Mark as hired. Once it is hired, the Convert to matter button appears in the header.
  3. Click Convert to matter.

What happens next depends on whether your firm has any active matter templates.

If your firm has matter templates: the template picker

A matter template is a saved blueprint for a kind of case (practice area, billing setup, default team, starting tasks, and so on). Esqase opens the convert dialog, titled with the lead's number (for example Convert LEAD-0012 to a matter), so you can pick one.

The convert dialog titled "Convert [lead number] to a matter", showing the Matter template dropdown and, below it, the checkbox that moves the invoicing matter's records into the new matter.
  1. In the Matter template dropdown, choose the template that best matches this case. The dropdown is searchable, so start typing to filter.
  2. If you have already billed the lead, a checkbox appears below the dropdown, ticked for you, reading for example Move the invoices and all other records from MAT-0031 to the new matter, then archive MAT-0031. Leave it ticked to fold the lead's small invoicing matter into the new matter, or clear it to keep the two apart. See If you already billed the lead.
  3. To create the matter immediately, leave a template selected and click Convert to matter. Esqase builds the new matter in the background and takes you straight to it. You will see a "Lead converted to matter" confirmation.
  4. To review every detail before saving instead, leave the Matter template field empty (the placeholder reads "No template (open the new-matter form)"). The button label changes to Open new-matter form. Clicking it opens the full new-matter form seeded from the lead (see the next section). Your choice on the checkbox carries over to the form.

When you convert with a template, Esqase fills the new matter from the lead's details plus the template's blueprint, with no further input required:

  • The matter is titled after the lead's primary contact and the template's practice area, for example "Jane Doe - Immigration". With its matter number in front, it reads MAT-0010 - Jane Doe - Immigration. You can rename it on the matter afterwards.
  • The lead's contact becomes the matter's primary client and bill recipient.
  • The practice area, matter types, default team, view permissions, billing setup, and starting tasks come from the template. A private lead always makes a private matter, whatever the template's view permissions. See Converting a private lead.
  • If the template carries a court, your firm has court rules turned on, and your role can add court dates, the matter gets that court too. Its case number, judge, and other case details start empty, so fill them in on the matter. See Applying court rules to a matter.
  • The matter's open date is set to today.
  • The matter is placed into the template's pipeline stage. If the template did not capture a stage, Esqase uses the first stage of that practice area.

Note: Templates do not carry custom-field values, so a templated matter starts with its custom fields empty (you fill them on the matter afterward). The same is true for the statute-of-limitations date and any related contacts: add those on the matter once it exists.

Important: If the template you pick has since been archived or deleted, Esqase cannot use it. It tells you "That matter template is no longer available, so the new-matter form was opened instead" and switches you to the full new-matter form so the conversion can still go through.

If your firm has no templates (or you want full control): the new-matter form

If your firm has no active matter templates, the convert dialog still opens (it confirms the conversion and, if you already billed the lead, offers the checkbox described above), but the Matter template dropdown reads "No active matter templates" and the button reads Open new-matter form. Clicking it opens the full new-matter form, already seeded from the lead. You also reach this form on purpose by leaving the template field empty in the picker.

This is the same step-by-step matter form used for any new matter, so you can review and adjust every detail before saving. For a full walkthrough of each step, see Creating a matter.

  1. The form opens with the lead's information pre-filled (see "What carries over" below). Work through the steps: Customers, Matter information, Custom fields, Assignees, View permissions, Related contacts, Billing, Document folder, Tasks, and Workflow.
  2. Adjust anything that needs changing, and fill in details the lead did not have (such as billing method, statute-of-limitations date, or team assignments).
  3. Save the matter to finish the conversion.
The new-matter form opened from a lead, showing the Customers and Matter information steps pre-filled with the lead's contact, practice area, matter types, and

Tip: The new-matter form path is the right choice when the case needs details the lead did not capture, when no template fits, or when you simply want to confirm everything before the matter is created.

What carries over from the lead

Conversion is designed so you do not re-enter information you already gathered during intake. The exact set depends on which path you take, but in both cases the lead's core details flow into the new matter.

Carried over in both paths:

  • The client. The lead's contact becomes the matter's primary client and bill recipient.
  • A matter title. Esqase titles the matter with the contact's name and the practice area, for example "Jane Doe - Immigration", the same way as a matter you create from scratch. With a template, the practice area is the template's, and the title is used as-is. In the new-matter form, the practice area is the lead's, and a title you type there replaces the suggestion. When the lead has no contact, the title is the practice area alone.
  • The practice area and matter types. The lead's practice area and any matter types it was tagged with are applied to the matter.
  • The lead's workflow checklist. Any workflow steps that were attached to the lead move onto the new matter, so the intake checklist continues on the case. See Workflows and the builder.

The lead's records move to the matter

Everything the team recorded on the lead's tabs moves to the new matter, so the case starts with its full history:

  • Tasks move to the matter's task board and keep their place: a task goes to the matter stage of the same kind (To do, In progress, or Done), or failing that the stage with the same name, or else the matter's first stage. See Lead tasks and their stages.
  • Notes move to the matter's Notes tab.
  • Meetings and scheduling requests. The lead's events, including meetings the prospect booked on your public booking page, move to the matter's Events tab, and so do scheduling requests still on the lead, so a time the client proposes later lands on the matter.
  • Unbilled time and expenses. Time entries and expenses on the lead that are not on an invoice yet move to the matter's Time & expenses tab, where they can then be billed. Entries already on an invoice stay with that invoice.
  • Communications (emails, calls, texts, and logs) move to the matter's Communications tab and stay associated with the new matter.
  • Documents move from the lead's folder into the matter's document folder, subfolders and files in the trash included, and the emptied lead folder goes to the trash. PDF forms filled from those documents move with them. The lead's Documents tab keeps showing the files in their new place.
  • Form submissions move to the matter's Forms tab, whatever their status. Their answers, files, and sent dates do not change.

Note: A lead folder kept in sync with a cloud drive moves as a whole folder, inside the matter's folder, so the sync keeps working.

If you already billed the lead

Billing a lead before you convert it puts its invoices on a small pre-engagement invoicing matter (see Bill a lead from the Invoices tab). When you convert, the convert dialog offers to fold that matter into the new one with a checkbox, ticked for you, that names it, for example Move the invoices and all other records from MAT-0031 to the new matter, then archive MAT-0031. The checkbox appears only when the lead has an invoicing matter that is not archived and that you can open.

With the box ticked, conversion also:

  1. Moves every record on the invoicing matter to the new matter: invoices with their payments and credit notes, transactions and trust deposit requests, payment plans, tasks, notes, events, time and expenses, communications, form submissions, documents, signature requests, comments, and its clients, team, related contacts, and custom field values (without doubling anyone the new matter already has).
  2. Archives the invoicing matter, and moves its emptied document folder to the trash.
  3. Posts a comment on the new matter's Overview tab, in your name: "Moved all records from [invoicing matter] to this matter when [lead] was converted. [title] is now archived." The archived matter gets a matching comment: "All records moved to [new matter] when [lead] was converted."

Archiving needs Update access for matters. Without it, the records still move, the invoicing matter stays active, and the comment says it was not archived because archiving needs permission to update matters.

Clear the box to keep the invoicing matter as it is: it stays active, keeps its invoices and payments, and stays on the lead's Matters tab next to the new matter.

Path-specific behavior:

  • Template path: the practice area, matter types, team, view permissions, billing setup, and starting tasks come from the template, along with its court when it has one; the open date is set to today; custom fields and the statute date start empty.
  • New-matter form path: the lead's contact, practice area, matter types, suggested title, and document folder are pre-filled, and you supply everything else (billing, team, statute date, custom fields, related contacts) as you would for any new matter.

Note: Custom-field values entered on the lead do not automatically transfer to the matter today. After converting, re-enter any custom-field values you need on the matter. See Custom fields.

Converting a private lead

A private lead always becomes a private matter, and the people assigned to the lead keep access to the case. This holds on both paths.

  • New-matter form path: the View permissions step opens on Specific members, and Everyone in the firm cannot be chosen. The lead's assignees are already on Members with access and cannot be removed, and the step reads "This lead is private, so its assignees keep access to the matter". You can still add other members.
  • Template path: the matter is private even when the template is set to Everyone in the firm. The lead's assignees are on its view list, together with the members and assignees the template brings.

Firm owners can always see the new matter. For who else can see it and what stays hidden, see Private matters and leads.

What changes about the lead after conversion

Once a lead has been converted, Esqase locks it so the prospect's record is preserved exactly as it stood at conversion, and links it to the matter it became.

  • The lead is marked hired and locked. Its status is set to hired, and it now has a matter attached. The Edit and Archive options for the lead are disabled, because the live case is now the matter, not the lead.
  • The status actions are replaced by a shortcut. Convert to matter, Mark as not hired, and Return to intake disappear. In their place, a View matter button appears in the lead's header so you can jump straight to the case the lead became.
  • The lead takes no new records. The buttons that add tasks, events, notes, documents, time, form submissions, invoices, and communications are hidden on the lead's tabs. The Tasks tab reads "This lead was converted to matter [number]. Its tasks now live on that matter." with a link to the matter's tasks. The lead's Matters tab lists the new matter as its Converted matter.
  • The outcome tables show it as hired. The lead appears under the Hired tab in your leads view. Because it is now converted (it has a matter), you cannot return it to intake from there; use View matter to reach the case instead.
  • The invoicing matter links back. The small matter created to invoice the lead, archived or not, shows a Lead row in its sidebar, above Clients, that opens the lead. See The page sidebar.
A converted lead's header, with the status actions gone and a View matter button highlighted next to Send email.

Note: A lead that is merely marked hired (but not yet converted) is different: you can still mark it not hired, return it to intake, or convert it, and it still takes new records. The lock only applies once an actual matter exists.

Convert automatically with a Convert to matter workflow step

If your firm runs the same intake steps on every lead, you can let a workflow handle conversion as part of that sequence. A workflow is a reusable checklist of steps that attaches to a lead; one of the available step types is Convert to matter.

Add the step when building a workflow

  1. Open your workflow in the builder. See Workflows and the builder.
  2. Add a step and choose the Convert to matter type. Its description reads "Convert this lead into a matter".
  3. In the step's Matter template field, optionally choose the template the conversion should use. The field is searchable, and the same placeholder, "No template (open the wizard)", applies.
    • Pick a template to convert headlessly when the step is applied: as long as that template is still active at conversion time, the lead becomes a matter immediately with no form to fill.
    • Leave it empty to open the full new-matter form at conversion time so a team member reviews the matter before it is created.
  4. Save the step.
The workflow builder's Convert to matter step configuration, showing the Matter template dropdown and its helper text about converting immediately versus

Apply the step on a lead

When a workflow is attached to a lead, its steps appear as a checklist on the lead detail page. The Convert to matter step opens the same convert-to-matter dialog as the header action, but with one convenience: you do not have to mark the lead hired first.

  1. Open the lead and find the Convert to matter item in its workflow checklist.
  2. Click Convert to matter on the step. It works whether or not the lead is hired, and converting marks the lead as hired for you as part of the conversion.
  3. The convert-to-matter dialog opens so you can confirm. It does not screen for conflicts: to screen the lead as part of the workflow, put a Conflict check step before this one. If you already billed the lead, the dialog shows the checkbox described in If you already billed the lead. Then, if your firm has matter templates, pick one:
    • If you pick a still-active template, the conversion runs from the lead's details plus the template and the step is marked complete.
    • If you leave the template empty (or the chosen template was archived or deleted), the new-matter form opens, seeded from the lead, for you to review and save.
  4. After conversion, the step is checked off and, like the rest of the lead's workflow, moves onto the new matter, where the remaining steps continue.

Tip: An Invoice workflow step does run on a lead, and it does not wait for a conversion. Invoices belong to a matter, so Esqase puts the draft on a small pre-engagement invoicing matter linked to the lead, which it creates the first time you bill that lead and reuses for every invoice after it. The lead itself is not marked hired, converted, or done, so you can bill a consultation without deciding whether to take the case. If you convert the lead later, you can move the invoicing matter's invoices and other records into the real matter. See If you already billed the lead and Creating and sending invoices.

Troubleshooting

  • I do not see a Convert to matter button. The lead is probably not hired yet, or your role does not allow changing lead status. Mark the lead hired first, and confirm your permissions with your firm owner.
  • It opened the form instead of converting instantly. That is expected when no template is selected, when the chosen template was archived or deleted, or when your firm has no active templates. Review and save the matter in the form to finish.
  • Convert to matter is gone and I see View matter. The lead has already been converted. Click View matter to open the case it became.
  • Converting says "This lead was already converted to a matter". The lead already became a matter, for example because a colleague converted it while you had the form open, so Esqase does not create a second one. Open the lead and click View matter to reach the case.
  • My custom fields are blank on the new matter. Custom-field values do not transfer automatically yet. Re-enter them on the matter. See Custom fields.

Common questions

  • Does converting delete the lead? No. The lead is kept (marked hired and locked) and linked to the matter, so you retain the full intake history.
  • Can I convert a lead that was never marked hired? Conversion always results in a hired lead. From the header you mark it hired first; from a workflow item's Convert to matter button you can convert directly whether or not the lead is hired, and Esqase marks it hired for you as part of the conversion.
  • The convert dialog did not offer to move the invoicing matter. The checkbox appears only when the lead has an invoicing matter that is not archived and that you can open. A lead you never billed has none.
  • Can I undo a conversion? Conversion is one-directional. Once a matter exists, the lead is locked to it. If a matter was created in error, manage it from the matter side (for example archive it). See The matter workspace.