Contractors

The companies working for the Customer, and each one's Countries and colour.

For: Customer Administrator · Contractor Administrator · HR Administrator · EHS Administrator · Report Viewer · System AdminLast checked: 2026-11-12Open this page in Obtempera ↗

One row per Contractor in your scope. A Customer Administrator sees every Contractor of the Customer, and System Admin every Customer's; a Contractor Administrator sees their own company and the subcontractors beneath it, never sideways or upwards (their Contractors menu item opens their Contractor Portal). An HR Administrator over a Country sees the Contractors in that Country with their colour; EHS, and HR over a Project, see the Contractors in their Country or Project without a colour: each reads Not assessed. A Report Viewer sees what the administrators beside them see, colours included, and changes nothing: no Invite Contractor or Create Contractor. A Licence Reviewer has no Contractors register.

The table

  • Contractor — the company, with how many Countries it is in.
  • Customer.
  • Countries — the first two by name, then +N for the rest.
  • Compliance — the company's colour: Green, Amber, Red or Not assessed (grey). It rolls up the company's Country declarations and its Workers' placements: any Red makes it Red, then any Not assessed, then any Amber; Green only when everything is Green. A declaration is grey until it is submitted and while it is in review, Red when it is sent back (Rejected) or suspended, and Green once approved; an approved declaration turns Amber while a required document in it expires soon (inside the question's warning period) and Red once one has expired, until the Contractor sends in the renewed document and it is approved. See Worker statuses.
  • Status — the company's own status: Active (green), Inactive (grey), Suspended or Archived (red). Archived Contractors are hidden until you ask for them (below).
  • Last Activity — when a declaration was last submitted or approved (Today, 1 day ago, N days ago).

Click a column heading (Contractor, Customer, Countries, Last Activity) to sort by it; click again to reverse it. Compliance and Status do not sort. The sort covers every Contractor you can see and stays in the page's address. On a phone, choose it under Filters › Sort by. Open a row for the Contractor record.

Tiles, search and filters

The tiles Total Contractors, Green, Amber (cleared, but one of its own Workers has a required document, licence or course expiring soon), Red (a declaration sent back or suspended, or one of its own Workers not compliant, expired, sent back, with training to do, or suspended) and Not assessed (grey: a declaration not yet submitted or in review, or one of its own Workers not checked yet) count the Contractors in your scope, archived ones only while they are shown; press one to show only those, and Total Contractors to show them all again. Countries counts the Countries they work in.

Search by Contractor, Customer or Country name; it starts from 3 characters. On a computer, filter a column from the funnel in its heading: Compliance (Green, Amber, Red, Not Assessed), Status (All but archived, All statuses, archived included, Active, Inactive, Suspended or Archived), Customer (every Customer you can see; System Admin sees them all) and Country. On a phone, those filters are under Filters. Filters always holds Sort by (name, Customer, most or fewest Countries, most or least recent activity).

Archived Contractors

Archived Contractors are hidden by default: they are not in the table, the tiles, the page count or the export. Switch Show archived (above the table) to On to list them with the rest, or choose Archived under Status to see only them; switch it Off to hide them again. The choice is the Status filter, so it stays in the page's address (?status=ANY) like the other filters, and a shared link shows the same view.

Adding a Contractor

A Customer Administrator or System Admin has two buttons:

  • Invite Contractor — names the Country and the person who will run the company, who is invited to fill in its declaration. See Invite a Contractor.
  • Create Contractor — makes the company and its first administrator at once, with no Country yet: Legal name, Trading name, then the Initial Contractor Administrator (Administrator email, First name, Last name). Nothing is emailed yet: the invitation email goes out when you add the company's first Country with + Add on its record, and the administrator sets their own password from it. Until then the record says so instead of offering Reinvite Admin.

Neither makes a second copy of a company the Customer already has: the message names the existing one. A Contractor invites its own subcontractors from its Contractor Portal, not from here.

Adding a Contractor for a site? The page points you to the Project instead: open it under Open Projects and press + Add Contractor. The company goes straight onto the Project and is invited to its Country declaration (see the Project page).

Several Contractors at once (System Admin)

System Admin ticks the box beside a Contractor's name, or the box at the top of the Contractor column to choose every Contractor on the page. With the whole page chosen, Choose all N matching takes every Contractor the search and filters find, not only this page; Choose this page only goes back to the page. A bar above the table says how many are chosen and offers:

  • Archive and Reactivate: Reactivate brings back only Archived Contractors. As on the Contractor record, archiving ends its Workers' placements and suspending pauses them, and its administrators are emailed.
  • New status…, then Change status: Active, Inactive or Suspended.
  • Send a message: opens Communications with the chosen Contractors' Workers as the audience. Obtempera does not write to a Customer's Workers itself: to send it, view Obtempera as one of the Customer's administrators and open the same address again. A message is one Customer's, so Contractors of more than one Customer are refused with the reason; Archived, Inactive and Suspended Contractors are left out, by name.
  • The export icon in the bar: the spreadsheet of Pages and links, with the same columns, for the chosen Contractors only (with all matching chosen, the whole filtered view).
  • Clear unticks them all.

Before anything changes, one confirmation lists every chosen Contractor and what happens to it (for example Active → Suspended), and those that will not change, with why (Already Archived.). Each Contractor then goes through the same checks as the status on the Contractor record, one at a time; one that is refused stays as it was. When it finishes the bar says how many changed and names every one that did not, with the reason, until you close it. A change takes at most 250 at a time: with more chosen, narrow the filter (the export still takes them all). Choosing a new page, search or filter lets the choice go. Nobody but System Admin has the boxes or the bar.

Pages and links

The footer says how many there are in all. Choose 25, 50 or 100 rows a page. The search, the filters, the page and the rows stay in the page's address, so Back, a refresh or a shared link shows the same view.

The export icon (an arrow into a tray, top right of the table) downloads every row of the current view, with its search and filters, as a CSV file: up to 10,000 rows, only what you can see here. Each export is recorded in the audit trail.