Documentation page
AI assistant
Fill forms from job notes and photos, find work, and check what the assistant can and cannot do
The AI assistant helps you fill forms and move around Tradie Forms on a paid plan. Give it job notes in plain language, attach a clear photo or file, or choose one of the suggested jobs. To speak your notes instead of typing, use the dictation button on your phone or computer keyboard, then check names, numbers, and readings before you send.
While a form is open, the same assistant appears as Fill with AI. It can fill matching fields, explain a section, find missing details, apply saved information, and help prepare the form for preview or download.

Open the assistant
You can open it in five ways:
- Select Assistant in the sidebar for a full-page chat. When the assistant takes you to another page, the chat moves to the side of the screen, or a floating panel on a phone
- Type a request into Ask the assistant on the Overview page
- Select the sparkle button in the app header from any app page
- Select Fill with AI in the form toolbar while filling a supported form
- Press Command + I on a Mac or Ctrl + I on Windows
The header assistant can find templates, drafts, completed forms, saved details, and app pages. Open it from a form when you want it to read or update that form.
On the Assistant page, Fill from a photo opens your photos with a starter message ready to send, and Resume links open your two newest drafts.
Closing the panel does not clear the conversation. After you have sent a message, use the New chat icon to start again. The old conversation moves to Recent chats, where you can open it again or delete it. Tradie Forms keeps your 20 most recent earlier chats. If you open the assistant in a new browser tab or window, select Restore last chat to carry on where you left off. Sending a new message instead moves that chat to Recent chats.
Change the layout
On a larger screen, the chat opens as a floating panel or a sidebar beside the form. On a phone it is always a floating panel. See Layout and controls to switch layouts, resize the panel, and learn what each icon does.
What it can do anywhere in the app
- Search the template library and help start a form
- Find and open recent drafts or completed forms
- Open app pages such as Templates or Saved details
- Find saved details and supported customer or site records
- Look up an ABN when enough information is provided
- Search these user docs when you ask how something works
- Explain your current plan and available account features
The assistant only works inside Tradie Forms. It is not a general-purpose advice service.
What it can do on a form
- Fill or change supported text, dates, choices, and checkboxes
- Split a name or address across the matching form fields
- Read what is already filled and tell you what still needs attention
- Open a section, focus a field, and explain what the field is asking for
- Review missing, invalid, or suspicious values
- Apply saved details or a form preset
- Find a connected ServiceM8, Fergus, or Xero job and import supported details
- Read visible text from an attached photo or supported small file
- Check whether the form is ready to preview or download
- Start a PDF download after showing you a confirmation
- Help save current details for next time after showing you a confirmation
- Open secure share-link settings for a saved form after showing you a confirmation
- Clear the form only after you explicitly ask and confirm
When Auto-apply saved details and jobs is on in Settings, those two actions apply immediately. Turn it off if you want a confirmation in chat first.
What it cannot do
- Add or draw signatures
- Add photos or diagrams to the form's own photo or drawing fields
- Invent a licence number, test result, address, date, or other missing fact
- Confirm that real-world work or information is correct
- Decide whether work complies
- Lodge, email, certify, or submit a form for you
- Guarantee that an AI reading of a photo or note is accurate
A good way to fill a form
Give it the job details
Type, paste, or use your keyboard dictation for the notes you already have. Include the customer, site, work, dates, readings, and results that should go on the form.
Let it update the supported fields
The assistant fills the fields it can match. If something is unclear, it may ask one short follow-up question.
Check what changed
Scan the filled sections. Ask What's already filled? or What's missing? when you need a quick summary. To take back a change, select Undo on that update in the chat. Undo works while the form stays open and leaves any field you have edited since.
Finish the manual parts
Add signatures, form photos, diagrams, and any details the assistant could not confirm.
Check the PDF
Select Check form, then use Review and Preview before downloading or sharing the PDF.
Prompts that work well
Give it the same concrete notes you would give an office admin:
Customer is Jordan Lee, 0412 345 678. Job was at 12 High Street, Ballarat. Service date was 28/07/2026. Replaced the damaged cover and tested the unit. Main device passed.You can also ask:
- "Fill the customer and service sections from these notes"
- "Use my saved contractor details"
- "Show me presets for this form"
- "Find job 1842 in ServiceM8 and import it"
- "Take me to the test results section"
- "Why is this field still marked incomplete?"
- "Review this form and tell me what needs attention"
- "What have I already filled in?"
- "Change the service date to 28/07/2026"
- "Is this ready to preview?"
Be specific when correcting something:
Change the Client Name to Jordan Lee. Leave the Business section as it is.Quick commands
Type / in the message box to open a list of commands. Available commands depend on whether a form is open.
Common commands include:
- Search templates
- Find drafts or completed forms
- Review form
- Explain section
- Apply saved details
- Import job
- Check download readiness
- Clear form
Selecting a command sends the matching request for you. Actions that replace or clear information still show a confirmation where required.
Photos, files, and pasted content
Use the plus for a job card, equipment label, meter photo, handwritten note, or small data file.
- Photos work best when text is close, upright, well lit, and in focus
- You can send one photo per message
- You can send one PDF per message, up to 3 MB and 20 pages
- Supported photos include JPEG, PNG, and WebP
- Supported small files include PDF, plain text, Markdown, CSV, and JSON
- Camera photos are resized before sending
- You can also paste an image or text into the message box
The assistant may show the values it read and how confident it is before applying uncertain details. Check serial numbers, dates, readings, names, and addresses carefully.
If a file is blocked, use a closer crop, send a smaller file, or type the important values into the message.
Saved details, presets, and connected jobs
Ask the assistant to list available items before applying them when you are unsure which one you need:
- "Show my saved business details"
- "List presets for this form"
- "Show jobs I can import from Fergus"
Saved details fill the matching reusable fields. Presets replace the current form values after confirmation. Connected job imports use the mapping saved for that connection where available.
Always update job-specific details such as the customer, address, dates, readings, serial numbers, and work performed.
What the assistant can see
While you chat, the assistant can receive:
- The current form and answers already entered
- The section you are working near
- Messages and attachments you send
- Saved details, presets, and connected job information when you ask it to use them
That information is processed by our AI provider to respond and suggest form updates. Do not send information you are not comfortable sharing for that purpose.
Select the information icon in the panel for the in-app reminder. Turning the assistant off under Settings -> Features hides the launcher and Fill with AI, and blocks assistant requests for your account.
If something goes wrong
| Problem | What to do |
|---|---|
| Upgrade required | Sign in on a paid plan |
| Button missing | Check that the AI assistant is enabled under Settings -> Features and that you are signed in |
| Wrong field changed | Name the exact field and correct value, or edit it directly on the form |
| It misunderstood several details | Start a New chat and send shorter, clearly labelled notes |
| Attachment blocked | Try a smaller JPEG, PNG, WebP, text, Markdown, CSV, or JSON file |
| Photo read incorrectly | Send a closer, clearer crop and provide the correct value in text |
| Assistant is still working | Select the stop square , then resend a shorter request |
| Too many requests | Wait briefly and try again |
Completing a form
Use sections, field checks, review, autosave, saved details, and toolbar actions
Layout and controls
Switch the AI assistant between floating and sidebar layouts, resize it, and learn what each icon does