Skip to content

Fill in and sign site reports

Start, fill in and co-sign a job's Pre-Start, Permit to Work, End of Day, Incident or Gear report, and find every report you've filed on Site reports.

For crewLast reviewed
On this pageBefore you start

A job can carry up to five kinds of daily report: Pre-Start, Permit to Work, End of Day, Incident and Gear. None of them gate your clock-in; they're a record of the day, not a checklist you must clear first. Start and fill each one on the job's own page, and find your reports later on Site reports.

Before you start

The job's team leader, or an owner, admin, dispatcher or office user, can start a report. If the job has no team leader, any crew member assigned to it can start one too.

Start and fill a report

On the job's Overview tab, under Today's reports:

  1. Select + Start a report. The menu shows every report kind and its status for today.
  2. Select Start report for a new report, or Continue report for a draft. The report opens in a sheet on desktop or as a bottom sheet in the app.
  3. Answer the questions your business set up. A Hazard assessment field can appear on a Task Analysis or another site-report template.
  4. Select Submit report. If it stays greyed out, open Still needed just above it and select an item to go to that question. The report stays open.

Complete a hazard assessment

Each section records an activity, one hazard, its initial risk, control measures, a level of control and its residual risk. Select a hazard and one or more control measures from your company's lists. The lists are separate, so choose the measures that apply to the activity.

For each risk, choose a consequence and likelihood. The form multiplies the two values to show the score and band: Low for scores 1 to 5, Medium for 6 to 12, and High for 15 to 25. Choose a level of control from the four options shown in the form. A section needs a hazard, at least one control measure, both risk ratings and a level of control before you can submit. Activity is optional. If the hazard assessment has no red star, it is optional: you can leave it empty and still submit, but a section you start must be finished or removed.

The field starts with one section ready to fill in. Select Add new section for another activity and hazard. Use Remove section to delete a section you no longer need. On a required hazard assessment, the last section stays; on an optional one, removing the last section clears it. The submitted report and its PDF show each section, the selected wording, risk scores and bands.

An image field says Up to 10 photos. Select Take photo or Choose from library. You can select several library photos in one visit. ONYX1 prepares each photo before it uploads. If one cannot be prepared or a live upload is refused, the notice names it and gives the reason. Choose a smaller or supported copy, remove a permanent failure, or use Retry for a temporary upload failure. This form uploads while the connection is available; it does not promise to keep a form photo in the offline media queue.

Your answers save on your device as you type. The form also saves draft changes to the server while you have a connection, after a short pause. If you lose signal, keep filling in the report on the page you already opened; your latest answers stay on the device. When you reconnect, make another change or submit to send the latest answers to the server. If you opened the report while online, the hazard and control lists remain available if the signal drops. The form saves the selected names with the answer, so later list edits do not change a saved or filed section. If you're not the one who can start a report, the job says "The team leader will start it." instead.

Photos and signatures inside these report fields are uploaded directly by the form, not by the offline media queue. If one fails, the file stays in the form and the form shows its own error, such as "Couldn't upload" or "Upload timed out. Check your signal." Use Retry for an image or Save signature again while you are online. These field uploads are out of scope for the separate queued-media refusal notice.

Co-sign

People who clocked in on the job on the report date can co-sign a report whose template requires crew sign-off. The person who filed the report can sign too if they were on that crew. The default Gear template does not require crew sign-off:

  1. Select Sign to confirm you’ve checked out.
  2. Sign, then select Save signature.

Before you draw, check the job number and title, report kind and date above the signature pad. If you or the workmate whose signature you are capturing are not assigned to that job today, ONYX1 asks you to confirm; choose Cancel to leave it unsaved or Sign anyway to continue.

If a workmate has no phone with them, select their name under "No phone? Sign for someone else on this one:", have them sign, then select Save signature. With no signal, your signature shows "Saved. It’ll upload automatically when you’re back online." The app keeps it queued on your device and retries it when the connection returns.

Someone from another company who is not on your team can sign too. You can use this flow in the web app on your phone. The native iPhone flow is in the next iPhone build. Under "Someone from another company? Sign for them on this phone:", select their name, hand over the phone, then select Save signature. They must be on the job for the day first. See Outside people on site.

If the server later permanently refuses a queued daily-report co-signature, ONYX1 saves the refusal details before removing it from the upload queue so later work can continue. The person whose device queued it sees a notice once explaining why, and can dismiss it. It says signature, not photo, and does not keep the signature bytes after the refusal. Draw the signature again when the notice asks you to. A refusal because the report no longer exists cannot be added back to that report.

If the report is submitted again after you sign, your signature stays on the report but is labelled Signed before the latest changes. That tells the people reviewing the report that the signature predates the current answers.

If a manager reopens an approved report for signatures, it appears as submitted again. You can add your co-signature from the report on the job. Signatures already on it stay there. The manager must approve it again before it can be sent.

If a manager sends it back

The job shows "Sent back by a manager:" and the reason. Fix the answers and submit again.

When the client uses its own form

Some clients, such as large manufacturers, issue their own pre-start or permit and do not accept ONYX1's. For the Pre-Start and the Permit to Work you can file the client's own document as that day's report instead of filling in ONYX1's form. End of Day, Incident and Gear always use ONYX1's form.

Who can file it: the job's team leader, an owner, admin, dispatcher or office user, a site supervisor, and, on a job with no team leader, any crew member assigned to it. A site supervisor can file the client's document on any job even though they cannot start ONYX1's own forms.

  1. On the job's Today's reports, select Use the client's document beside the report. If you have already started ONYX1's form for the day, ONYX1 asks "Discard the ONYX1 draft and use the client's document instead?" before it goes ahead. Only the person who started the draft, the job's team leader, or an owner or admin can switch it.
  2. Choose Photos or PDF.
    • Photos: photograph each page in order, or choose them from your library. In the Android app Take photo opens the phone's own camera, and you can add up to 30 pages and move or remove a page before you submit. Filing in the iPhone app is in the next iPhone build; its photo field allows 10 pages and lets you remove them but not reorder them. Until then, use ONYX1 on the web. Submit waits while pages are still uploading ("Uploading 2 pages").
    • PDF: choose the file the client issued, up to 20 MB. A blank or renamed file is refused.
  3. Add the Client reference (for example the client's permit number) and a Note if you want to. Both are optional.
  4. Select Submit.

It becomes that day's report and goes to a manager to approve. A day has one Pre-Start and one Permit to Work, so you use either ONYX1's form or the client's document for each, never both.

The row shows Client document, the reference and the version. ONYX1 does not collect signatures on it: the sign-offs are on the client's own form, so there is no crew sign pad and the report never appears under signatures waiting on you.

  • Replace file: until a manager approves it you can replace the file. The report stays submitted and earlier versions are kept.
  • If it is sent back: the row shows "Sent back by a manager:" and the reason. Select Add the corrected file, then submit again.
  • After it is approved: you cannot replace it. An owner or admin can reopen an approved client document that has not been sent, and then you add a new version.

Note

On iPhone, filing the client's document is in the next app update. Until then, use ONYX1 on the web.

One open Permit to Work at a time

A job can only have one Permit to Work open at once. If a permit was started and never finished, starting a new one on the same job does not create a second draft: it reopens the one that's still open, whatever day it was started on, with a note saying which day that was: "A permit to work from [day] is still open. Finish it or discard it."

If the permit is no longer needed, the person who started it, the job's team leader, or an owner or admin can select Discard it and confirm. A discarded permit stays on Site reports marked Discarded; it does not count toward anything waiting on approval, and the job is free to start a fresh permit straight away.

Find your reports on Site reports

Open Site reports from the menu to see every daily report across your jobs, newest first, on one screen.

  • One row of filters sits above the list: type buttons (All types, Pre-Start, Permit to Work, End of Day, Gear, Incident), then Any status, All jobs and a date range on a wide screen. On a phone, select Filter for the status, job and date fields. Choose a filter and the list updates. Clear removes them all.
  • The list grows with the page. A dot beside the date means you haven't opened that report yet.
  • The list holds the latest 200 reports that match the filters. When it reaches that, the line under it says so; narrow the filters to find an older report.
  • Select a report to see it beside the list. The preview shows its status, who approved it and when, whether it was emailed to the customer, and the PDF itself, with Download PDF and Full screen. Use J and K, or the arrows, to move through the reports.
  • A report you can still finish shows Continue report, which takes you back to the job. Open full job opens the job.
  • An owner or admin can use Approve or Send back in the preview for a report waiting on approval. The report's filer and the person who submitted its form cannot review it.

On a phone, select a report to open it full screen. The PDF is not embedded there: use Download PDF or Full screen to read it.

Nothing opens a PDF until you select a report, because a report with no PDF yet is prepared the first time it is opened.