Completing Forms on Jobs
In one sentence: Technicians and staff open the Forms area on a job, fill in each required form, and submit it — after which it can be printed as a PDF, renewed if it expires, and (for multi-use forms) completed again up to the per-job limit.
What Is This?
The filling-in side of Forms: how forms appear on jobs (and customers), the statuses a form moves through, printing completed forms as PDFs, expiry and renewal, and what the experience looks like in the technician mobile app (the app from version 4.0 onwards). For designing forms, see Building & Managing Forms.
Why Does This Matter?
How It Works
Where forms appear
- On a job (web app): open the job's Actions menu and choose Forms. The item appears whenever there are published forms available for that job.
- On a customer (web app): customer-linked forms are opened from the customer's Options menu, also under Forms. The item only appears when the business has customer-linked forms.
- On the mobile app: the job card has a Forms button, and a customer's page has a Forms section when the business has customer-linked forms.
The web app opens a dialog called Allocated Forms. It lists each form with its Name, what it is For (Job or Customer), its Version and its Status. The status reads Not Started, Draft, Completed or Expired. A completed form whose expiry date has passed shows Expired instead of Completed. Each row has icons to open the form (the tooltip reads Start form, Edit draft form or View completed form), to Duplicate it (multi-use forms that have been started) and to Print it. Below the table, an Other forms list with an Add Form button lets you start any other available published form. Job types with "Only Allow Linked Forms" ticked hide that list.
The beta form editor is available to every user and is still in beta. The web app asks which editor to use each time you open or start a form. Use original opens the editor the app has always had. Use beta editor opens the Beta form editor. On a form with more than one section, its section menu lists every section, with a dot beside each one that is empty, half-filled (a ring), complete (solid) or holding an error (yellow). Fields without a section are listed under General. Each section is a collapsible panel and opening one closes the one that was open. The editor checks fields as you fill them in and saves an unsaved copy in the browser automatically. If the browser closes before you save, the form asks "Resume where you left off?" the next time, with Restore and Discard. The original editor is still available.
Form statuses
| Status | What it means |
|---|---|
| None | Not started |
| Draft | Started, saved, but not yet submitted — can still be edited |
| Completed | Filled in and submitted |
A draft form opens for editing, with Save Draft and Complete buttons on the web app and Save Draft and Submit on the mobile app. A completed form opens read-only for viewing, and the mobile app warns "Form will not be editable after this point" before you complete it. The mobile app also saves a draft on its own a couple of seconds after each change.
The one exception is a customer-linked form with Form Expires switched off. Its completion stays editable after it is completed, and the form shows an Update button instead of Save Draft and Complete. Job forms, and customer forms that expire, cannot be changed once completed.
Editing the form template never changes a form that has already been completed; it keeps the version it was filled in on. A draft started on an older version can be moved onto the newest published version. The beta editor shows an Update to Latest Version link, the original editor shows an upgrade icon with the tooltip "Upgrade form", and the mobile app offers Upgrade Form to New Version in the form's options menu.
Multiple completions
For multi-use forms, each new completion is a separate copy with its own status — useful when the same checklist is done per unit on a multi-unit visit. Up to 20 copies per job are allowed (the default limit, configurable per business). Single-use forms allow one completion.
A second copy is always made from an existing one, on the web app and on the mobile app alike. Add Form on the web app and Add additional forms on the mobile app only list forms that are not on the job yet, so they cannot start a second copy of a form that is already there.
- Web app: in the Allocated Forms dialog, a multi-use form that has been started shows a Duplicate icon next to the edit and print icons. Clicking it asks you to "Name the new form" (it suggests the form's name plus "Copy"), then opens the new copy as a draft to fill in. A name that another copy already uses is refused with "This name is already in use". Copies of the same form are grouped together in the list, and each one can be opened, completed and printed on its own.
- Mobile app: tap the three dots on the form's card and choose Re-Use Form, give the copy a name, and fill it in. The same menu has Rename, which changes the name of any copy.
On both, if two or more copies of that form are still untouched, a "Heads up! You have made some unused copies of this form." warning offers View existing copies or Re-use anyway, because forms cannot be deleted. Once the limit is reached, the app shows "You have reached your form limit" with the limit in brackets and no copy is made.
Printing (PDF output)
Any form completion can be printed to a PDF with the Print icon in the Allocated Forms dialog, or the Print button inside an open form. On the mobile app, open the form, tap the three dots and choose Download, which needs an internet connection ("Internet connection is required to download document" appears without one). The PDF is a rendered copy of the form's answers, named after the form and timestamped, and can be downloaded and emailed to the customer — the usual way completion certificates are delivered.
Expiry and renewal
If the form definition has an expiry timespan, the expiry clock starts when the form is completed — the expiry date is set to the completion time plus the configured timespan. Once that date passes:
- The completion shows Expired in the Allocated Forms dialog, and its title carries "(EXPIRED)" when opened
- A Renew action starts a fresh draft of the same form to be filled in again (the old completion remains on record). On the web app it is the Renew button at the top of the open form, shown on a completed form that expires. On the mobile app it is Renew Form in the form's three-dot options menu, shown once the form has expired
Enforcement — "you must complete the form"
Form completion is enforced on job statuses. Link the form to the job type (Settings → Jobs → Job Types, open the type, Add Form), then tick Complete Forms on the status that must wait for it (Settings → Jobs → Statuses). The web app and the mobile app then refuse to move a job to that status until every form linked to its job type is completed and not expired. The mobile app checks the latest published version of each linked form. To block closing, tick Complete Forms on the status that has Close Job ticked. With Advanced workflows, tick it on the matching status in each workflow.
A task checklist can also carry a step of type Complete Forms. That task completes itself once all the job type's forms are completed and not expired. On the mobile app this happens when the technician opens that task. It only holds up a status change when that status has Complete Tasks ticked. See Job Task Checklists.
The technician mobile app
The mobile app (version 4.0 and later) has a dedicated forms screen per job, titled "Forms for" followed by the job number. It shows:
- A progress bar — "x Of y Forms Completed"
- A To Do tab (drafts, including partly filled ones, and required forms nobody has started) and a Completed tab
- A card per form with its name, what it is For, its Status (a draft that already has answers reads "Draft - In Progress"), the completion date, a Single-Use badge when it applies and the Version
- A three-dot menu on each card with Rename, and Re-Use Form for multi-use forms, which starts another copy for the next unit, up to the per-job limit
- An Add additional forms button that lists forms not yet on the job. It is hidden when the job type has "Only Allow Linked Forms" ticked
- Form definitions and completions synchronise to the device, so forms are filled in on site and synced back
Inside an open form, the three-dot Form Options menu appears when it has something to offer. It can hold Upgrade Form to New Version (the form is a draft and a newer published version exists), Renew Form (the form has expired) and Download.
Signing a form
A Signature field on a form is set up by the field's signature template. An Employee signature asks for the employee from a pick-list. A Customer signature asks for the signer's name. If the template has terms, the signer can read them first. After signing, the form shows the signature image, or a tick with "Signature is hidden" when the template hides it, and a Re-sign button only when the template allows it. See Signature Templates.
- Web app: the signer draws on the screen and confirms. A Customer template with the QR code option also shows "Signing on a different device? Scan the QR Code below.", so the customer can sign on their own phone. Keep the window open until the customer has finished.
- Mobile app: the field shows a Sign Here button, which becomes View Signature once signed. It opens the Manage Signature screen. Pick the employee or type the customer's name, tap Sign (which stays off until a name is given), draw, and tap Save. The form signature screen in the mobile app has no QR code option. A customer who must sign on their own phone has to sign through the web app, or through the older mobile app if the technician has not updated. The job's own Signatures screen in the mobile app is separate and does show a customer QR code.
Key Terms
| Term | What It Means |
|---|---|
| Draft | A started, editable completion that hasn't been submitted |
| Completed | A submitted completion, read-only from then on unless it is a customer-linked form that never expires |
| Expired | A completion older than the form's expiry timespan (clock starts at completion) |
| Renew | Start a fresh draft of an expired form; the old one stays on record |
| Beta form editor | The newer way of filling in a form on the web app, offered next to the original editor each time a form is opened |
| Duplicate | Start another copy of a multi-use form on the same job. The web app calls it Duplicate; the mobile app calls it Re-Use Form |
Common Scenarios
Scenario: "The technician can't close the job — it says forms are outstanding"
What the customer sees: A job status that won't move. The mobile app says "Forms need to be completed and expired forms need to be renewed and completed." and the web app says "You need to complete all required forms." What happens in the system: The target status has Complete Forms ticked, and at least one form linked to the job's type is not completed on this job, or its completion has expired. What staff should know: Open the job's forms, check the To Do list on the mobile app, submit what's outstanding and renew any expired form. If the message says tasks need to be completed instead, the status has Complete Tasks ticked and a task on the job is still open.
Scenario: "The customer wants a copy of the certificate"
What the customer sees: An emailed PDF. What happens in the system: Staff open the Allocated Forms dialog on the job, print the completed form to PDF, and email it. What staff should know: Printing works for any completion, draft or completed — but send the completed one. The PDF's Employee line names the person who completed it.
Scenario: "The form shows Expired — did we lose the data?"
What the customer sees: Expired in the Status column next to an old completion. What happens in the system: Nothing was lost — the completion is intact; it has simply passed its validity window (completion date + expiry timespan). What staff should know: Open the form and use Renew to start a fresh completion. The expired one remains viewable and printable.
Scenario: "On the web I can only fill in the form once"
What the customer sees: The form is complete on the job, and Add Form does not offer it again. What happens in the system: Add Form only lists forms that are not on the job yet. Further copies of a multi-use form are made from the existing copy. What staff should know: Click the Duplicate icon on the form's row in the Allocated Forms dialog, name the copy, and fill it in. No Duplicate icon means the form is single-use or has not been started yet.
Important Rules & Gotchas
- The expiry clock starts at completion, not at job creation — two forms of the same type completed on different days expire on different days.
- Completed forms are read-only. Corrections mean a new completion (duplicate or renew), never editing history. The only exception is a customer-linked form with Form Expires switched off, which keeps an Update button after completion.
- Template edits do not reach completed forms. A completed form keeps the version it was filled in on; only drafts can be moved to the latest version.
- The 20-per-job cap on multi-use forms is the default and can be configured per business.
- "Only Allow Linked Forms" on the job type controls whether extra, unlinked forms can be added to a job.
- Draft ≠ done — a form saved as draft does not count toward the required forms; only submitted (Completed) forms do.