Clock in/out
Start and stop your timer from Home or Clock in/out, record a break, answer a long-shift check, and sign a safety form a job needs before you can start.
On this pageOn an iPhone
The clock is on Home and the Clock in/out entry under Team on a computer or in More on a phone. My week has a Clock in/out link to the same clock. Use it to start and stop your timer, record breaks, answer a long-shift check, and sign a safety form a job can ask you to complete before you start.
On an iPhone
The ONYX1 clock field widget uses the ONYX1 mark and can show your clock status or next assigned job on the Home Screen and Lock Screen. When you clock in successfully in the ONYX1 app, the widget and Live Activity show the running timer. They are display-only: tap the widget or Live Activity to open the Time screen in ONYX1. It has Clock out while you are clocked in, or Clock in with no job when you are not. The field widget does not show a customer name or full street address.
On Apple Watch with watchOS 11 or later, the iPhone app can show the Live Activity in the Smart Stack so you can see the timer at a glance.
In the native iPhone app, you clock in per job. Open the job and select Clock in, or select Clock in to this job on its card on Today, the first tab for crew. Owners, admins, dispatchers and office staff open on Home instead, and reach Today by choosing the Trade view under View in More when they have jobs assigned. Then select Clock in now. The job clock sheet has no job picker. For time that is not on a job, use Clock in (no job) in the Clock section on Today, or Clock in with no job on the Time screen. Choose a job on the Time screen opens your jobs. See Use ONYX1 on your iPhone.
If your business shows crew the time left on the job, the latest version of the iPhone app shows it on the widget, the Live Activity and Apple Watch too, always with the time it was worked out. See Time left on the job.
The field widget has no Updated footer. If a widget says Open ONYX1 to refresh or shows a stale status, open the app before relying on it. While a clock is open, the widget may say Break not recorded; choose and confirm your break when you clock out.
Before you start
If a job has a required safety form, open its Safety tab, complete the form from Forms, and sign it before you can clock in on it. If a job is waiting for the owner to approve its safety documents, it doesn't appear in the job picker at all until that clears. Clocking in and out both need a signal; with none, wait until you have one and try again.
If ONYX1 won't start your timer and the message has a Why? link, select it. Chippy explains why and what to do, or the help article opens if Chippy is hidden or switched off. See Ask why something was refused.
Clock in
- Open Home or Clock in/out. From My week, select Clock in/out.
- Open the job picker and search by job title, customer or job number if you need to. Jobs assigned to you appear under Assigned to you, followed by the other jobs; each row shows its job number and customer. For a technician or contractor, the other jobs are the public jobs that are still open. Clocking in on one of them adds you to its crew. Leave it on No job for time that isn't on a job.
- Select Clock in.
The card switches to a running timer. If your business records clock-in locations, ONYX1 takes a location reading first and clocks you in either way, even if the reading fails. A notice can follow the clock-in:
- Away from the site: "You appear to be away from the job site, so this clock-in has been flagged."
- In a browser, location blocked by the site: "Your clock-in was recorded without a location, because location is blocked for this site. To allow it next time, tap the icon at the left of the address bar → Location → Allow."
- In a browser, location unavailable for any other reason: "Your clock-in was recorded without a location. Check your browser’s location setting before your next clock-in."
- In the ONYX1 Android app, location blocked: "Your clock-in was recorded without a location. Turn on Location for this device and allow ONYX1 to use it."
- In the ONYX1 Android app, location unavailable for any other reason: "Your clock-in was recorded without a location. Check that Location is turned on for this device."
Select Dismiss to clear the notice. None of these block the clock-in itself; an off-site clock-in is visible to your managers on Team.
Clocking in on a Scheduled job moves its status to On site. For an unarchived On site job that should still be Scheduled after an accidental clock-in, someone who manages job statuses can select Move back to Scheduled on the job page. The job needs a booked start date and any required safety-document approval must be clear. This changes the job status. It does not change or delete the clock-in entry. Make any available time-entry edits separately in Your timesheet. See Job statuses.
Time left on the job
If your business has switched it on, you see how much of the job's planned crew time is left while you are clocked in on that job. Time that is not on a job has no countdown. Where you see it:
- On the job's page on the web, near the top, whatever your role.
- On the clock card on Home, if you are crew. Owners, admins, dispatchers and office staff see it there only in the Trade view; otherwise their Home has no clock card, so they use the job's page.
- In the latest version of the iPhone app, on the clock card on Today, and on the job's page while you are clocked in on that job. Crew land on Today; owners, admins, dispatchers and office staff reach it only in the Trade view.
- In the latest version of the iPhone app, on your iPhone's ONYX1 clock widget, in the Live Activity on the Lock Screen, and on Apple Watch. These can't count down, so they show the figure at a set moment with that time beside it, for example 6h 40m left · as of 10:42 am. The figure is right as of that time, not now. It moves on when you open the app, when you clock in, and every five minutes while the app is open on Today.
- The big figure under Time left counts down, for example 6h 40m. The line under it reads like Planned 24h · Used 17h 20m · 3 on the job now.
- Planned is the quoted hours set on the job. Used is everyone's time on the job added together: every finished shift, approved or not yet approved, plus every timer running now, less the breaks recorded.
- The figure counts people-hours, so it drops faster when more people are on the job. With three people clocked in, it drops three minutes every minute.
- It is green while more than a quarter of the planned time is left, and amber in the last quarter, down to zero. Once the crew goes past the planned time it turns red, reads, for example, 1h 20m over, and counts up.
- If the job has no quoted hours, you see On this job and the crew's total time instead.
The figure keeps counting when you have no signal, and catches up with everyone else's time when you come back to the page or the app with a signal, and every few minutes while it stays open. A break comes off the used time once it is recorded on the shift, even if the shift is still running. A timer someone forgot to stop keeps counting against the job until the shift is fixed. You only ever see hours here, never rates, costs or prices, and it never sends you a notification.
On job cards
With the setting on, every job card and job row also shows the time left, whether or not you are clocked in, for any job you can see. It is a thin bar with a line such as 12h 30m left of 40h, or 2h 10m over 24h once the crew goes past the plan. It uses the same colours as the countdown. It is worked out when the page or screen loads and does not count down. A job with no quoted hours shows nothing here.
You see it on:
- Home: the cards under My jobs today and the rows under Coming up this week for crew, and the Today rows for owners, admins, dispatchers and office staff.
- The Jobs list, and the cards on the Board view.
- In the latest version of the iPhone app: the job cards and Coming up this week on Today, the Jobs list, and the Today rows on Home.
When you clock out
When you clock out of a job with quoted hours, the clock-out step shows Time left on this job after this shift, for example 12h 30m left of 40h, with the bar and a line such as Your shift today: 8h 13m, less 30 min break. It counts everyone's time on the job, including this shift, less the break you are entering, and changes as you change the break. It is information only and never stops you clocking out.
After you clock out with the Clock out button, a short note shows for a few seconds, for example Clocked out at 3:15 pm and 7h 43m worked today on Harbour Cafe., with the job's time left. On the web it shows above the clock; in the iPhone app it shows at the top of Today.
Sign a required safety form
Open the job from the Open the job link in the refusal, or from its own page. Select Safety, then Forms, and under the form that needs signing:
- Fill in the form.
- Select Sign off.
If the form is a signature, select Save signature once you've signed. Once it's signed, the form shows signed and you can clock in.
Take a break and clock out
- Select Clock out.
- Under Lunch / breaks today, select None, 15m, 30m, 45m or 1h, or type the minutes yourself.
- Select Confirm clock-out.
Record your lunch every day you work more than 4 hours. A day over 4 hours with no lunch recorded is flagged for whoever approves your week, because a lunch that is not recorded is paid as work time. None counts as no lunch. If you forgot, you can add it to the line on your timesheet before you hand the week in. If you clock out for your lunch instead, and clock back in at least 30 minutes later the same day, that gap is already unpaid and the day is not flagged.
If a break you already recorded is longer than the shift, the confirm step tells you so; lower it and try again. Cancel returns you to the running timer without closing the shift.
If you forgot to clock out
If you finished a while ago and the timer is still running, don't use Clock out, which records the finish as now.
- Select Finished earlier? next to Clock out.
- Set the time you actually finished, then select Clock out at this time.
- Choose your break and select Confirm clock-out.
The shift closes at the time you set. Cancel closes the time picker and leaves the timer running. Once a shift has run long enough for the Still on site? card below, use the card instead.
If your shift runs long
Past the point your business checks in on long shifts, a Still on site? card appears above Clock out:
- Select Yes, still going if you are, and the card goes away until the next check-in point.
- Select No, I finished at this time if you finished earlier, after fixing the time shown to your real finish. This opens the same break step as Clock out and closes the shift at that time, not now.
A finish time before your clock-in is refused: "That time is before you clocked in. Check it and try again."
After you clock out
If the job has an End-of-Day report due today, a reminder appears: "You clocked out. Don’t forget today’s End-of-Day report." Select Fill or sign it to open the job, or Dismiss to clear the reminder.
Your shifts
Below the clock, My timesheet lists your entries, newest first: the job, when you started, and how long you worked, or an on the clock pill while a shift is still open. For the full week and to hand it in for approval, open Timesheets, covered in Your first day on the tools.
