Job Task Checklists
In one sentence: Task items are tick-off checklist steps on a job (or query) — each one can capture a piece of information when completed, and a job status can be configured to be unreachable until every task is done.
What Is This?
A task item is a single checklist step on a job — "Test the unit", "Take a photo of the installation", "Get the customer's signature". Technicians work through the list and mark each item complete. Completing an item can require capturing something: a value, a photo, a signature, or a completed form.
Task items can be added one at a time, or in bulk from a task template — a reusable, ordered checklist the business defines once (for example, a standard installation checklist). Templates can also be linked to a Job Type, so the right checklist is available for the right kind of work.
This is a separate, lighter-weight feature than the custom Forms system. Forms are full documents with many fields; task items are a checklist — though one task item type can require completing forms as its step.
Why Does This Matter?
Checklists are how a business makes sure field work is done consistently. Without them, whether a technician remembers to photograph the installation or capture a signature depends on the technician. With task checklists:
- Every job of a given type carries the same steps
- Each completed step can capture proof (a photo, a signature, a reading)
- A status change (for example, to "Complete") can be blocked until all tasks are done — the technician physically cannot skip the checklist
How It Works
Where tasks appear
Task items live on the job (and also on queries). On the mobile app, technicians open the job and tap Tasks to get the Task Items screen for that job, where they can view, complete, edit, reorder and (with the Add task items permission) add items with Add Task Item. On the web, the same list is available on the job.
On a closed job the phone hides the edit pencil, the Add Task Item button and the reorder handles, but technicians can still tick items complete.
Adding tasks to a job
- From a template: choose "add template items", pick a task template, and select which of its items to add. Templates are defined for either jobs or queries.
- One at a time: add a single task item with a description (required), optionally a due date, one or more assigned employees, and a data type for what must be captured on completion.
What a task can capture
Each task item has a data type that controls what completing it requires:
| Type | What the technician must do |
|---|---|
| Text / Number / Date / Date & time | Enter a value |
| Yes-No | Answer a yes/no question |
| Select / Multi-select | Pick from configured options |
| Take photo / Attachment | Attach a photo or file to the job |
| Customer signature | Capture the customer's signature |
| Employee signature | Capture the technician's signature |
| Complete forms | Complete the job's required forms — the task only completes once the forms are completed |
Completing (and un-completing) a task
Ticking a task with a data type opens the completion screen for that capture. Tasks can also be un-ticked if marked complete by mistake. Each item shows who it is assigned to and its completion state.
On the phone, the completion screen will not save an empty answer. It shows "Text is required", "Number is required", "Selection is required" (Yes-No and Select), "At least one option required" (Multi-select), "Date is required" or "At least one attachment is required, or mark as incomplete" (photo and attachment). Once an item is complete the screen also offers Mark as Incomplete. Signature and Complete forms items have no Mark as Complete button. A signature item completes as soon as the signature is captured, and a Complete forms item completes by itself when the job's required forms are done, otherwise the screen shows how many of them are still outstanding.
Task templates
Templates are managed in Settings (Task list). A template has:
- A name and a module — Job or Query
- An ordered list of task items (items can be reordered)
- Each item's description, data type, options (for select types), and other settings
Templates linked to a Job Type (in the job type's settings) make the right checklist available for jobs of that type.
Tasks and job statuses
A job status can be configured with a "tasks completed" requirement. When a technician or office user tries to move the job into such a status, the system checks the job's active task items — if any are incomplete, the change is blocked with the message "You need to complete all tasks." On the phone the message is "Tasks need to be completed." under the heading "Cannot change job status."
The status setting is called Complete Tasks in Settings → Jobs → Statuses, and its neighbour Complete Forms does the same for the job's required forms. The setting is not offered on a start status.
Key Terms
| Term | What It Means |
|---|---|
| Task item | One checklist step on a job or query |
| Task template | A reusable, ordered set of task items defined by the business |
| Data type | What must be captured to complete the item (photo, signature, value, forms…) |
| Add task items permission | The permission needed to add task items; without it, staff can view and complete but not add |
Common Scenarios
Scenario: A technician tries to complete a job but is blocked
What the customer sees: Nothing — the technician resolves it on site. What happens in the system: The status change is refused with "You need to complete all tasks." because the target status requires task completion and items are outstanding. What staff should know: Open the job's task list and complete the outstanding items (or deactivate ones that don't apply).
Scenario: The business wants a standard installation checklist
What happens in the system: An admin creates a task template with the steps in order, then links it to the "Installation" job type. Technicians add the template's items to the job (or find them ready to add) and work through them. What staff should know: Templates are per module — a job template does not appear for queries and vice versa.
Scenario: A step needs proof
What happens in the system: Give the task item a "Take photo" or "Customer signature" data type. When the technician ticks it, the capture screen opens and the photo/signature is stored against the job. What staff should know: The "Complete forms" type won't complete until the job's required forms are completed (and not expired).
Important Rules & Gotchas
- Adding task items requires the Add task items permission; viewing and completing them does not
- Task items exist on jobs and queries — not on quotes, invoices, or other modules
- A status configured to require tasks blocks the change while any active task item is incomplete — deactivate items that genuinely don't apply
- "Complete forms" tasks depend on the job's forms being completed and not expired
- Task items are different from the Forms feature — a checklist step vs. a full structured document
- Items can be assigned to specific employees, but any user with access to the job can complete them