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 carries over, 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.
- The lead must be hired first. The Convert to matter action 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 (or use the workflow path below, which walks you through it).
- 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.
📷 Screenshot: The lead detail page for a hired lead, with the Convert to matter button highlighted in the header action bar.
Suggested image: images/converting-leads-to-matters/lead-header-convert-button.png
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.
- Any conflict check has cleared. See Running a conflict check.
- You are ready to begin tracking tasks, time, documents, and billing against the case.
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 stays editable and can still be put back to your kanban 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.
- 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.
- If the lead is not already hired, click Mark as hired. Once it is hired, the Convert to matter button appears in the header.
- 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). If at least one active template exists, Esqase opens the Convert to a matter dialog so you can pick one.
📷 Screenshot: The convert dialog titled "Convert [lead number] to a matter", showing the Matter template dropdown with the placeholder "No template (open the new-matter form)".
Suggested image: images/converting-leads-to-matters/convert-template-picker.png
- In the Matter template dropdown, choose the template that best matches this case. The dropdown is searchable, so start typing to filter.
- 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.
- 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).
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 (for example, "Jane Doe matter").
- 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.
- 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, clicking Convert to matter skips the picker entirely and 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.
- The form opens with the lead's information pre-filled (see "What carries over" below). Work through the steps: Customers, Matter information, Custom fields, Team, View permissions, Related contacts, Billing, Document folder, Tasks, and Workflow.
- 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).
- Save the matter to finish the conversion.
📷 Screenshot: 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 matter title.
Suggested image: images/converting-leads-to-matters/new-matter-form-seeded.png
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 suggests a title based on the contact's name (for example, "Jane Doe matter"). You can change it in the new-matter form before saving; the template path uses the suggested title as-is.
- 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 document folder. If the lead had collected documents, that folder is carried into the matter so files stay with the case.
- 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.
- Communications. Emails and other logged communications tied to the lead stay associated with 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; 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.
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. The Mark as not hired, Put back to leads kanban, and Convert to matter buttons 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 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 put it back to intake from there; use View matter to reach the case instead.
📷 Screenshot: A converted lead's header, with the status actions gone and a View matter button highlighted next to Send email.
Suggested image: images/converting-leads-to-matters/converted-lead-view-matter.png
Note: A lead that is merely marked hired (but not yet converted) is different: it stays editable, and you can still unmark it, put it back to your kanban, or convert it. 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
- Open your workflow in the builder. See Workflows and the builder.
- Add a step and choose the Convert to matter type. Its description reads "Convert this lead into a matter".
- 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.
- Save the step.
📷 Screenshot: The workflow builder's Convert to matter step configuration, showing the Matter template dropdown and its helper text about converting immediately versus reviewing in the form.
Suggested image: images/converting-leads-to-matters/workflow-convert-step-config.png
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 works just like the header action, with one helpful guardrail.
- Open the lead and find the Convert to matter item in its workflow checklist.
- If the lead is not hired yet, the step guides you to mark it hired first (a lead must be hired before it can be converted).
- Click Convert to matter on the step.
- If the step was configured with a still-active template, the conversion runs immediately and the step is marked complete.
- Otherwise the new-matter form opens, seeded from the lead, for you to review and save.
- 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 cannot run on a lead, because invoices belong to a matter. On a lead, that step prompts you to mark the lead hired and then convert it to a matter; once the lead becomes a matter, the invoice step moves over and you can create a draft invoice from it.
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.
- 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; the workflow step prompts you to do the same before it will convert.
- 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.