Schedule jobs and assign crew
Set a job's dates and who is on it from the job page, or plan the whole shop's week on the Planner.
On this pageOn the job page
Set a job's dates and who's on it from its own page, or plan several jobs and crews at once on the Planner.
On the job page
Only the owner, admins, dispatchers, office staff and site supervisors can schedule jobs and assign crew. Owners, admins, dispatchers and office staff can also change Schedule and Crew on the job's Edit tab, which is open on any job that is not finished or archived; see Edit a job from the Edit tab.
To change them from the Work tab, find the Schedule and crew card on the job and use its editors:
- Select Edit schedule. Set the Start date. Start time defaults to 7:30 am; change it if the job starts at a different time. For work that runs more than one day, set an End date too.
- Select Save dates.
- Select Edit crew, then tick each person who is on the job.
- To have someone on for only part of the job, use the From and To date fields that appear once they're ticked. Leave both blank and they're on for the whole job.
- Select Save crew.
If the job requires owner approval of its safety documents and they aren't approved yet, saving a date keeps the job in New rather than moving it to Scheduled; see Job safety documents and owner approval.
You can give a subcontractor job dates while it stays in New. For an agreement hold, the date-saved notice says, "Date saved. This job stays in New until a signed agreement on the current version is uploaded." For missing or expired insurance, or expired prequalification, it says, "Date saved. This job stays in New until an owner or admin records an insurance override reason." The status messages say a current signed agreement is required, or that an owner or admin must record an insurance override reason before the job can leave New. The agreement requirement has no override. See Manage subcontractors.
The Planner
The owner, admins, dispatchers, office staff and site supervisors can open Planner, a whole-shop schedule across every crew. Open Planner from the menu.
Choose a view
On a desktop, choose a view at the top. Day by day and By person open on the week that holds today, and Month opens on this month. The Planner remembers the view you last used on that browser.
- Day by day shows three weeks, one row per day, with each day's jobs listed together. If today's row is below the bottom of the screen, the Planner scrolls down to it. The arrows move two weeks at a time. People on leave are named on each day's row.
- Month shows up to three jobs and two projected jobs on each day. Select a day's number, +N more or +N projected to open that week in Day by day.
- By person shows one week with a row for each person, grouped by team. Booked jobs with nobody assigned sit in the Not crewed lane, and people outside any team are under No team.
In Day by day and Month, each job shows its title, customer, start time and the initials of the crew on that day. A job with nobody assigned is marked Not crewed. Approved leave is hatched and pending leave is dashed, and a booked job whose crew is on approved leave that day has an amber outline. Public holidays for your region and published company holidays are shaded and labelled with their names (see Public holidays and company holidays).
On a phone or other narrow screen, Planner shows a day view with a seven-day picker instead.
Book and move jobs
- Find jobs without a booking in the To schedule strip. Select its heading to hide or show the jobs; the Planner remembers your choice on that browser.
- Drag a job onto a day. In Day by day and Month, the job keeps its crew and team. In By person, drop it on a person's row and day: that person becomes the job's whole crew. A job with no team keeps no team, even if that person belongs to a named team. A job that has a team moves to the person's team, or to no team if the person isn't in one; only the owner and admins can change a job's team. On a phone, open To schedule and choose a job to open its scheduling controls.
- To move a booked job, drag it to another day in the same way. A job that runs for several days keeps its length, and anyone on the crew with their own dates on the job has those dates moved by the same number of days.
What saves straight away. A move that only changes the dates, or only adds people to the crew, saves at once. A message confirms it and offers Undo for a few seconds. Undo puts the dates back, or takes the added people off again along with the dates the move gave them. It doesn't change the job's status back. Only the latest move of a job can be undone; moving the same job again removes the earlier Undo. Booking a job that had no date has no Undo; drag it to another day or open the job to change it.
The Planner refuses a move it can't save and says why, for example booking a New job whose quote isn't accepted when your business requires one, adding someone with an expired critical compliance item, or moving a finished job.
What asks first. The Planner shows a confirmation, and offers no Undo afterwards, when a move:
- takes anyone off the crew, including a By person drop onto someone else, because any dates of their own on the job are cleared and can't be put back;
- puts someone on the crew on a day of their approved leave (pending leave doesn't stop a move);
- gives someone on the crew a second job on one of those days, in which case both jobs stay booked and the confirmation lists each clashing job;
- is for a job whose safety documents aren't approved yet, so it stays in New;
- is for a subcontractor job with an agreement or insurance hold, so it stays in New with its dates saved and the matching hold reason shown;
- moves the job to another team;
- takes the job's team leader off the crew, which leaves the job without a team leader until one is set on the job page.
Change a job from its drawer
Select a job in any view to open its drawer (a To schedule job with a projected date opens its job page instead). You can also reach each job with the keyboard and press Enter. Use Move dates or Change crew instead of dragging; the same rules apply, so adding someone saves straight away with Undo, and taking someone off asks first. Move dates moves everyone's own dates by as many days as the start moved, then trims them to fit the new booking. Anyone whose own dates fall entirely outside it goes back on for the whole booking, and Undo doesn't bring their own dates back. Changing the crew of a job that has no booking also books it, on today if the view shows today and otherwise on the first day it shows, so the Planner always asks first. On a job that has a team, each person you add must belong to that team.
Only the owner and admins can change a job's team or the team definitions; the Planner refuses the change for other roles. On a booked job, owners and admins can select New team… in the drawer's Team field, name the team, choose its members and confirm assigning it to the job. The team is created when you select Create, so it stays even if you then cancel the assignment.
If safety documents need owner approval, the date saves but the job stays in New. The assigned crew cannot clock in on it until the documents are approved.
For a subcontractor agreement or insurance hold, the dates also save while the job stays in New. The date-saved notice says the job needs a signed agreement on the current version, or an owner or admin insurance override reason. In the Planner, the job is labelled Agreement needed · stays in New, Re-sign needed · stays in New or Insurance override needed · stays in New. The move confirmation and job drawer explain what must be cleared before the job can leave New.
When a job runs longer than planned
ONYX1 keeps each job's original plan: the start date and the number of days it was booked for, taken the first time the job got a date. If the job is later booked for more days than that, ONYX1 marks it as extended. This is a flag for you to notice, not a block. The change saves as normal and needs no approval.
- Moving a job to other dates while keeping its length does not count. Neither does shortening it.
- When a job is finished before its booked end, only the days up to the day it was completed count.
- A job taken back to New and booked again keeps its first plan.
- A job that already had dates when this feature was added uses those dates as its plan.
The owner, admins, dispatchers and office staff see the flag on the job and on the Planner. Site supervisors and field crew do not.
- On the job's Work tab, the Schedule and crew card shows an Extension line, for example "Planned 3 to 5 Nov, now ends 8 Nov (+3 days)", and the Extension reason when one is saved.
- On the Planner, an extended job has an amber +N mark next to its title, such as +2.
- On Job Health, which only the owner and admins can open, the Extended column shows the extra days; see Job health.
Add a reason
A reason is optional, up to 500 characters.
- On the Planner, when a move makes a job longer than its plan (for example, a later End in the drawer's Move dates), the message reads Extended by N days (or Extended by 1 day) and offers Add reason. Select it, write why under Why is this taking longer?, then select Save reason.
- On the job's Edit tab, use the Extension reason row. It shows on open jobs that are extended, for the owner, admins, dispatchers and office staff.
The job's activity records who changed its dates. When a reason is added, changed or cleared, the activity records that, without the reason's text.
What happens next
Once a job has a schedule date, it appears on the Jobs hub's Schedule and desktop Gantt views, and on the Map for jobs with usable coordinates, as well as in the Planner, for whoever can see those. On a phone or in the ONYX1 app, opening the Gantt view shows List instead.
