Building forms
Forms let your firm collect structured information from people, whether that is a brand-new prospect filling out an intake questionnaire on your public link, or an existing client completing a form you sent them. You build each form with a drag-and-drop editor, control who can use it, and decide what happens when someone submits it.
This page covers the Forms workspace: how to find your forms, create one, organize it into pages, take it live or pull it back, archive and restore it, and preview it before anyone sees it. For a deep tour of the editor itself, see The form builder in depth.
Before you begin
- A form lives at the firm level, so any member with access can find it (unless you mark it private to yourself).
- What you can do depends on your role:
- To create a form, you need Create access for forms. If you do not, you will not see the New form button.
- To edit, archive, or restore a form, you need Update access.
- To permanently delete an archived form, you need Delete access.
- Owners and Administrators have full access. Attorneys have full access. Staff can view, create, and edit forms but cannot delete them.
- If your role does not include view access for forms, the page shows a "no access" message instead of the list.
- A form that creates leads from a public web link (a Lead intake form) needs your firm to have a username set, because the public link is built from it. If you have not set one yet, see Your firm profile and details.
View and manage the forms list
The Forms workspace is your home base for everything form-related. You reach it from the sidebar, and it opens to a table of your firm's forms.
- In the sidebar, click Forms.
- At the top of the page you will see these tabs:
- Forms lists every form you have built.
- Submissions lists every form submission in the firm: the forms you sent, the ones your firm is filling in, and the answers that came back. (Working on them is covered in Reviewing form submissions.)
- Stay on the Forms tab to manage your forms.
Note: PDF forms, such as USCIS forms, are not a tab here. They are listed with your templates under Documents > Templates, and an old link to the PDF forms tab opens that page. See Document templates.
On both tabs, as you scroll down the table, the search box, the filters, and the column headings stay at the top of the page, while the page heading and the Forms and Submissions tabs scroll away with the list.
Each row in the table shows:
- Name of the form, with a PDF form or Template badge when a PDF form or a document template uses its answers. See See which documents use a form.
- Lead intake, which reads Yes if the form creates a lead and contact from every submission, or No for a plain data-collection form.
- Shared?, which reads Yes if every member of the firm can use the form, or No if it is private to you.
- Status, shown as a badge: Active (live and usable) or Archive (set aside).
- Updated by and Last updated, so you can see who last touched the form and when.
Note: By default the table shows only Active forms. Archived forms are hidden until you change the Status filter.
Find a form
You have a few ways to narrow the list:
- Type into the Search forms box to filter by name.
- Click the Status filter and choose Active, Archive, or both. This is how you switch between your live forms and your archived ones.
- Click a column header (such as Name or Last updated) to sort.
- If you have applied filters or a search, a Clear filters button appears. Click it to reset back to the default Active view.
Tip: To see everything you have ever built, open the Status filter and select both Active and Archive.
Row actions
At the start of each row is an actions area. Every form shows a View button, and depending on the form's status and your role you may also see a Copy link button and a More form actions menu (the "..." button):
- View opens the form's detail page, where you can see its submissions, send it to a client, and review responses.
- Copy link appears only for an active lead-intake form that has a public link. It copies that public web address to your clipboard so you can paste it into an email, a website, or a message.
- The More form actions menu ("...") holds Edit, Preview, Archive, Restore, and Delete, shown only where they apply (for example, Restore and Delete appear only on archived forms).
Act on several forms at once
If your role allows it, you can select multiple forms and act on them together:
- Use the checkboxes on the left of each row to select forms.
- A batch actions control appears. Depending on what you selected and your role, you can Archive, Restore, or Delete the selected forms in one step.
- Archiving and deleting ask you to confirm first.
Create a new form
Creating a form is a two-step experience: you name it and set a few options in a dialog, then you land in the builder to add your questions.
- In the sidebar, click Forms.
- Click New form in the top right. (If you do not see this button, your role does not include create access for forms.)
- In the Create form dialog, fill in the details:
- Form name (required): a clear name your team will recognize, for example "New client intake". You can change this later.
- Lead intake form (a checkbox, off by default): turn this on if you want every submission to automatically create a lead and a contact. See Public lead-intake forms for the full story. When you turn it on, two more options appear:
- Public link (required when lead intake is on): the last part of the web address where people will reach the form. Your firm's link prefix is shown to the left, and the rest is yours to set. It must be unique among your firm's forms.
- Workflow (optional): choose a workflow to attach to each new lead. The default is Don't attach a workflow. The workflow's steps are added to the lead. Steps set to run on their own start by themselves when the workflow's Automation switch is on, unless your firm has turned off Run automatic steps on these leads; the rest wait for your team in the lead's Workflow section. A workflow only applies to lead-intake forms. See Assigning and attaching workflows.
- This form is available for all members of the firm (a checkbox, on by default): leave it on so any member can use the form. Turn it off to keep the form private to you.
- Click Create form.
When you click Create form, the form is saved and goes live immediately, and you are taken straight into the builder so you can start adding questions.
Note: A new form starts with no questions. It is live the moment you create it, but it has nothing to fill out until you add elements in the builder and save. For a lead-intake form, remember the rule shown in the dialog: it needs a Name field and either an Email or a Phone field.
Edit a form's settings later
To change a form's name, sharing, lead-intake setting, public link, or attached workflow after it exists, you have two paths:
- From the forms table, open the More form actions menu ("...") on the row and click Edit to open the builder, then adjust the options in the right-hand Form settings panel.
- Inside the builder, all of these settings live in the Form settings panel on the right whenever no element is selected.
The form builder at a glance
The builder is a full-screen, three-column editor where you assemble your form by dragging elements onto a canvas.
- From the forms table, open the More form actions menu ("...") on a form and click Edit, or click New form to create one and land here automatically.
- You will see three areas:
- On the left, the element palette: a list of building blocks (text fields, email, phone, name, address, dates, dropdowns, checklists, file upload, headers, and more) that you drag onto the canvas.
- In the middle, the canvas: a preview of your form where you arrange and reorder elements.
- On the right, the settings panel. With nothing selected it shows Form settings (name, sharing, lead intake, public link, workflow, and the confirmation message). Select any element and it switches to that element's settings, where you set the label and the Merge key (the name documents use to fill in its answer), mark it required, add validation rules, and add show/hide conditions.
- At the very top is the toolbar with the form's name, a Preview button, a Copy link button (for lead-intake forms), and a Save button. Before them, the AI Assistant button (the sparkle icon) opens the assistant in the right-hand column, where it can build or change this form for you (see Work in a builder with the assistant).
Important: Your changes in the builder are not saved until you click Save. The Save button is enabled only when you have unsaved changes, and you must save before you can preview.
For a complete walkthrough of every element, validation rule, and conditional-visibility option, see The form builder in depth.
Send a form to a client or fill one in
Once a form is built, you use it with a client from the record you are working on:
- From a lead or a matter: on its Forms tab, click New submission, pick the form, and choose Manually fill up form to fill it in yourself, or Send to client to email it to the client. See Start a new submission.
- For someone who is not a lead yet: on the form's detail page, click Create request. See Send a form to a specific person, or fill it out yourself.
- When you add a lead: in New lead, choose Select a form under Follow-up. See Form submission modes.
- From a workflow: a Form step sends the form, and its Form menu offers Fill on client's behalf, Send to client, and Copy link. See Form step.
Every one of these creates a submission with its own page, where you fill in answers, send the form, comment, and mark it complete. Sending always asks you to confirm first, and the client can open the form only once it is sent. See Send the form to the client.
Fill documents from a form's answers
The answers people send back on a form can fill your documents. Each question has a Merge key, and a document placeholder named after it, {{<merge key>}}, fills in that question's answer. A question with the merge key date_of_birth fills {{date_of_birth}}.
- Documents that use the older spelling,
{{form_answer_date_of_birth}}, keep filling the same answer. - When a merge key is spelled the same as a placeholder Esqase already fills, such as
{{lead_number}}, the form answer is used. - A merge key that starts with a number, such as
2nd_address, keeps the older spelling,{{form_answer_2nd_address}}. The builder shows you which one to use.
- In the builder, select a question and copy its placeholder with the copy button beside its Merge key. See Merge keys and documents.
- Paste the placeholder into a document or a template. You can also insert it from the document's Placeholders panel: in Insert a field, open Form answers and pick the form in Show answers from.
- On a document filed with a lead or matter that has a completed submission of the form, click Fill from records, or let a workflow Document step create the document. See Document placeholders.
Tip: Give each question a merge key that says what the answer is, such as date_of_birth or opposing_party, before you build templates on it. Renaming a key later stops existing templates from filling that answer.
Fill a PDF form from a form's answers
A form's answers can also fill an uploaded PDF, such as a USCIS form. Set the PDF up as a PDF form, link the form, and map each of the PDF's fields to an answer. Esqase can also build the form for you from the PDF. See Filling PDF forms such as USCIS forms.
A USCIS form from the Form library comes with its own form, which the Form library keeps for you. See The USCIS form library.
See which documents use a form
Before you change or archive a form, check what fills from it.
- On the forms list, a PDF form badge beside the form's name means a PDF form is linked to the form, and a Template badge means a document template uses its answers. Hover a badge to see the first three by name, followed by how many more, for example and 2 more.
- On the form's own page, the Linked documents group in the sidebar lists them under PDF forms and Templates, up to ten of each, then how many more. A PDF form shows its form number and edition, for example Form I-130, edition 04/01/24, carries a Library badge when it came from the Form library, and opens on its Fields tab. A template opens in the editor. A form nothing uses reads Not used by a PDF form or template yet.
A template counts when its text, any of its tabs, or its header or footer holds a placeholder for one of the form's questions: {{<merge key>}} or {{form_answer_<merge key>}}. A placeholder Esqase fills on its own, such as {{firm_name}}, does not count, even when a question's merge key is spelled the same way.
You see the badges and the Linked documents group only when your role includes View access for documents, and they count only the PDF forms and templates you can open. Archived PDF forms and templates, and documents in the Trash, are not counted.
Organize a form into multiple pages
Long forms are easier to fill out when they are split into pages. The builder lets you add as many pages as you need, and respondents move through them one at a time.
- Open the form in the builder.
- Scroll the canvas to find your first page. Each page is labeled, for example Page 1 of 1.
- Drag elements from the palette onto the page to add your questions.
- To add another page, click Add new page at the bottom of the canvas. A fresh empty page appears below.
- Drag elements onto the new page the same way. You can move elements between pages by dragging them.
- Each page header updates to show its position, for example Page 2 of 3.
To remove a page:
- On the page you want to remove, click Remove page in its header. (This appears only when the form has more than one page.)
- Confirm in the Remove this page? dialog.
Important: Removing a page permanently removes every element on it. Move any elements you want to keep to another page first.
- Click Save when you are done.
Tip: Group related questions on the same page so respondents see a logical flow, for example contact details on page one and matter details on page two.
Publish, unpublish, and archive a form
In Esqase a form is "published" the moment you create it: it is Active straight away, and a lead-intake form's public link starts working right away. There is no separate publish button to press. What you control instead is whether a form stays Active or gets set aside as Archive.
Make a form live
- Create the form (see Create a new form). It is Active as soon as you click Create form.
- Add your questions in the builder and click Save.
- For a lead-intake form, grab the public address with Copy link (from the row or the builder toolbar) and share it. The link works as long as the form is Active.
Take a form out of use (archive)
Archiving is how you "unpublish" a form. It moves the form to Archive, hides it from the default list, and stops it being used. For a lead-intake form, archiving means its public link no longer leads to a usable form.
- In the sidebar, click Forms.
- On the form's row, open the More form actions menu ("...").
- Click Archive.
- The form moves to Archive. A confirmation appears, and the form drops out of the default Active view.
Note: A USCIS form from the Form library comes with its own form here. While the Form library is on, Archive on that form's row asks you to confirm in Archive form?, and archiving or deleting it, from its row, from selected rows, or from the form's own page, adds While the Form library is on, a Form library sync brings this form back. See The USCIS form library.
Note: Archiving does not delete anything. The form, its questions, and its past submissions are all kept. You can restore the form at any time.
Common questions
- Can I unpublish without archiving? Archiving is the way to take a form out of use. If you only want to stop sharing a lead-intake link temporarily, archiving is the cleanest option; restore it when you are ready again.
- Does archiving remove past responses? No. Submissions you have already received stay available on the Submissions tab and on the form's detail page.
Restore an archived form and delete a form
Archived forms are not gone. You can bring one back, or permanently remove it if you are sure you no longer need it.
Restore a form
- In the sidebar, click Forms.
- Click the Status filter and select Archive so your archived forms appear.
- On the form's row, open the More form actions menu ("...") and click Restore.
- The form returns to Active and becomes usable again. For a lead-intake form, its public link works again.
You can also restore several forms at once by selecting their checkboxes and choosing Restore from the batch actions.
Delete a form
Deleting is permanent and is only available for forms that are already archived, so archive a form first if you want to delete it.
- In the sidebar, click Forms.
- Set the Status filter to Archive to see archived forms.
- On the form's row, open the More form actions menu ("...") and click Delete. (You will only see Delete if your role includes delete access for forms.)
- In the Delete form? dialog, read the warning and click Delete form to confirm.
Important: Deleting a form cannot be undone. If you are not certain, archive the form instead so you can restore it later.
Troubleshooting
- I do not see Restore or Delete. Those actions appear only on archived forms. Switch the Status filter to Archive first. Delete also requires delete access for forms; if your role lacks it, the option is hidden.
- I do not see the "..." menu at all. The menu only shows actions you can take. If a form is active and you have no edit or delete rights, there is nothing to show beyond View.
Preview a form
Previewing shows you exactly what a respondent sees, so you can check labels, page breaks, required fields, and the confirmation message before anyone fills it out.
- Open the form in the builder.
- If you have unsaved changes, click Save first. The Preview button is disabled until your changes are saved, and a tooltip reminds you to "Save your changes to preview".
- Click Preview in the top toolbar. The preview opens in a new browser tab.
- In the preview, fill out and move through the form just as a respondent would, including multiple pages if you added them.
- Submit in the preview to see your confirmation message. If you set a custom Title and Message under the Confirmation message settings, you will see them here; otherwise you see the default "Thank you!" message.
You can also start a preview from the forms table:
- On an active form's row, open the More form actions menu ("...").
- Click Preview. It opens in a new tab.
Note: A preview is for your eyes only. Anything you type or submit in the preview is not recorded as a real submission and does not create a lead or contact.