Skip to content

Install ONYX1 on your phone

Get the ONYX1 app on your iPhone, iPad or Android phone or tablet, or install ONYX1 from the browser on an iPad, a tablet or a computer.

For owners, office staff and crewLast reviewed
On this pageGet the app on a phone

Get the ONYX1 app on an iPhone, an iPad, or an Android phone or tablet: the iPhone and iPad app from the App Store, the Android app from Google Play. Both use the same account and workspace as the browser. The released Android app shows the ONYX1 mark while it loads, and its Choose from library uses the device gallery and prepares the selected photos before upload. The iPhone and iPad app has its own screens for today's jobs, clocking in and out, photos and your timesheet. See Use ONYX1 on your iPhone, which also applies on an iPad (the Lock Screen Live Activity needs iPadOS 26 or later there), and Find your way around for how a tablet is laid out.

The browser still works on a phone. Sign in at onyx1.app and use ONYX1 as normal. What phones no longer offer is adding ONYX1 to the home screen.

On an iPad, an Android tablet or a computer, you can also install ONYX1 from the browser, as described below. Get the app in the menu is for phones, so on a tablet search for ONYX1 in the App Store or Google Play.

Get the app on a phone

Open the menu (the button at the top left, or More in the tab bar). Near the bottom, above Help, select Get the app. On an iPhone it opens the App Store listing, and on an Android phone it opens Google Play.

If you added ONYX1 to your phone's home screen earlier, opening that icon now shows Get the ONYX1 app. Select the button to download the app, or open onyx1.app in your browser instead.

Before you install from a browser

Sign in to ONYX1 in your browser on the iPad, tablet or computer.

Find Install app

  • On a computer, select your name at the bottom of the sidebar, then Install app. In the icon rail, select your picture instead.
  • On a tablet, a wide screen shows the sidebar, as on a computer, so Install app is in the menu that opens when you select your name. A narrow one opens the menu from the button at the top left or from More in the tab bar, where Install app is near the bottom, above Help.

On an Android tablet or a computer

  1. Select Install app.
  2. Confirm in the install prompt your browser shows.

On an iPad

  1. Select Install app. ONYX1 shows Add ONYX1 to your home screen.
  2. Tap Share, following the steps ONYX1 shows: it points you to Safari's toolbar or Chrome's address bar.
  3. ONYX1's steps then say: scroll down and tap Add to Home Screen.
  4. ONYX1's last step: tap Add, and the ONYX1 icon lands on your home screen.
  5. Select Got it to close the steps.

In a browser other than Safari or Chrome on an iPad, such as Firefox, Edge or Opera, ONYX1 asks you to open onyx1.app in Safari instead, then tap Share and Add to Home Screen there.

If ONYX1 asks you to sign in the first time you open it from your home screen, sign in with your usual email and password.

If the Android app asks you to update WebView

The released Android app needs a supported Android WebView to display ONYX1. If it shows Update Android System WebView to use ONYX1, select Update. After the update finishes, return to ONYX1 and select Try again.

If your device does not have the Play Store app, Update opens the Google Play page in your browser instead. If ONYX1 cannot identify the WebView provider, Update opens a generic Android System WebView search.

If you lose your connection

If you lose your connection while ONYX1 is open, the home-screen version and the released Android app keep the current ONYX1 screen available. Supported job status changes and job or incident photo uploads are saved on the device and sent when the connection returns. Closing and reopening either one does not discard those queues. Wait for the pending work to finish syncing before uninstalling the app or clearing ONYX1 site data.

If a queued site or incident photo, or a daily-report co-signature, is permanently refused, ONYX1 saves the refusal details before removing its bytes from the queue and shows the person whose device queued it a notice once. The notice explains why and can be dismissed. A different person signing in on the same device does not see it. Image and signature fields inside a form-fill report are different: a failed file stays in that form with its own error and retry control rather than appearing in this notice.

If Install app isn't there

  • Inside the ONYX1 app or an installed home-screen version, neither Install app nor Get the app shows.
  • On a phone, the row is Get the app, not Install app.
  • On an Android tablet or a computer, Install app appears only when your browser offers to install ONYX1. If it never appears, keep using ONYX1 in your browser: it works there without installing.