Add attachments and comments describing the work carried out to the correct task. A device's general operating instructions may belong in the Spot's files, but a photo or completion note for this particular job usually belongs to the task. There are separate instructions for adding files to a Spot.
Before adding anything
Open Tasks, find the job and open its details. In the browser, you can open a task by clicking its name or the pencil icon on its row. Check the task name and its associated Spot before uploading or submitting anything. If needed, see the instructions for finding a task.
Being able to see a task does not by itself give you permission to add anything to it. In the browser, adding an attachment requires permission to edit or manage the task, or to manage its attachments. Adding a completion comment requires permission to edit or comment on the task. Adding a standard task attachment on mobile requires permission to perform the task; in read-only mode, the app prevents you from adding attachments and comments.
You can also add attachments and completion comments to a completed task if your permissions and the controls available in that view allow it. Completion alone does not prevent additions. If a button is missing or disabled, or a submission is rejected, ask your administrator to check your permissions.
Add an attachment in the browser
- Open the task's Basic info tab and expand the Files section by clicking its heading if it is not already open.
- Click Add files and select the files. You can also drop them onto the Or drop files area.
- Wait for the upload to finish. A successfully uploaded file appears in the task's attachment list. The filename is used as the attachment description when adding it, so use a recognizable name.
For an existing task, uploading starts as soon as you select a file, and the attachment is saved separately. You do not need to use the task's main button to save the attachment. Closing the form without saving other changes does not undo an attachment that has already been saved.
When creating a new task, the selected files wait for the task to be created. Uploading starts only after successful creation. If you continue working on the task after creating it, upload progress is shown in the task view that opens. If you close the creation form without creating the task, the queued attachments are not saved to a task.
Add an attachment on Android
- Tap the add icon to the right of the task's Attachments section heading.
- Select Document to choose a file from your phone, Camera to take a new photo or video, or Gallery to select a saved photo or video.
- After selecting a document, enter a title for the attachment and tap Save in the window that opens. After selecting photos or videos, check the previews, enter a title for each selected attachment and tap Apply in the selection dialog.
- Wait for the files to upload and check them in the task's attachment list.
The camera requests permission to access your camera if needed. Allow access if you want to take photos or videos from the app. You can select up to three photos or videos at a time from the gallery. This limit applies to a single selection, not the total number of attachments on the task; you can add more later.
Add an attachment on iOS
- Tap the add button in the task's Attachments section heading.
- Select Document, Camera or Gallery. The document option lets you select one file. With the camera, you can take a photo or video; from the gallery, you can select up to three photos or videos at a time.
- Check the titles in the attachment preview window that opens and replace unclear default names with names that describe the work. Upload the attachments using the window's green APPLY button.
- Wait for the upload to finish and check the attachments on the task.
Gallery selection works on iOS 14 and later. The three-item media limit applies to a single selection, so add further attachments in a new selection if needed.
Use the iOS Document option for PDF files in these instructions. The picker also displays other document types, but uploading them and preserving their correct file type have not been verified. Add other documents in the browser.
Attachment limits and checking that files were saved
The browser's file picker supports common image, video, audio and document formats, such as JPG, PNG, MP4, PDF, Word and Excel files. This support does not establish that every file format or every mobile picker works.
The server's size limit for a single attachment is less than 1025 megabytes. However, the instructions in the browser's upload area show 100 megabytes, so the text and the server limit differ. Successfully selecting a large file on mobile does not yet mean that it will upload successfully.
Keep your network connection available and wait for the upload to finish before leaving the task. Open the task again, check the attachment's name in the list and open it to confirm that the correct content was saved. The add window closing does not by itself prove success. If an upload fails while adding several attachments, first check which files have already been saved, then upload only the missing ones again.
Add a completion comment
Describe, for example, what was done, what was left undone and what any deviation relates to. The comment must not be empty, and its maximum length is 4096 characters.
- In the browser: open the task's Completion comments tab. Enter your comment in the Add completion comment field and click the button with the same name next to the field.
- On Android: tap the green plus icon below the task's Comments card. Enter your comment in the window that opens and tap its Save button. Tap the Comments card to open the comment list.
- On iOS: tap the add button on the task's Comments card. Enter your comment and tap SAVE in the comment view. Tap the Comments card to open the comment list.
The comment is saved using its own button. Simply typing in the field or marking the task as complete later does not replace submitting the comment. Open the task again and confirm that the text appears correctly in the comment list.
Where is the information saved, and what does it change?
A standard completion comment belongs to the same task conversation as the task's messages in Work Chat. These are not two separate comments. Work Chat visibility and message handling depend on permissions. Adding message attachments and editing and deleting messages are described in the Work Chat instructions.
A file added through the task's Attachments section is linked to the task. An attachment added to a message in Work Chat is also linked to that message. If you need an attachment specifically associated with a message, add it in the conversation. Deleting a message also deletes its message attachments.
If a note concerns one field on the task form, use a field-specific comment so the information can be found in the right place. A form field's comment and attachment are separate entries from the task's general completion comment and attachment. See the instructions for filling in a task form.
Review comments belong to a separate task review stage. A standard completion comment does not replace a required review entry.
Adding an attachment or comment does not itself start processing the task, mark it as complete or change its status. Do not assume that a PDF report already generated will update when something is added: check the content of the report you need separately. There are separate instructions for reviewing tasks and reports.