Your account, password and two-factor authentication
Change your own name, phone and photo, see your pay rate, change your password, turn on two-factor authentication, and reset your password if you're locked out.
On this pageChange your name, phone or photo
My account is your own page. Every role can open it, whatever else they can reach in ONYX1, and it only ever shows you your own information. On the web it has these tabs:
- Details: your photo, name and phone, which you can change, and your email, role, job title and pay rate, which you can only read.
- Certs: your own certificates and gear, with their photos and PDFs. It shows when your business has Health & Safety.
- Leave: your balance, a form to request leave, and your recent requests.
- Timesheets: your own weeks. Select one to open it.
- Bonuses: your own bonuses. It shows when your business has Finances.
- Settings: who you're signed in as, your password, two-factor authentication, light or dark setting, Phone tabs, the getting started tour, a deletion request, and Chippy and Microsoft 365 where they're available.
In the iPhone and iPad app, select your profile row at the top of More to open My account.
Change your name, phone or photo
- On the web, open My account. Details opens first.
- Under Your details, change Name or Phone and select Save. Leave Phone empty to remove it.
- Under Photo, select Add a photo (or Replace photo) and choose a JPEG, PNG or WebP image of up to 5 MB. Select Remove photo to go back to your initials.
In the iPhone and iPad app, open My account and select Edit name and phone, change them and select Save. For your photo, select Add a photo or Change photo, then Take photo, Choose from library or Remove photo.
Your name has to look like a person's name. ONYX1 refuses a name with a year in it, or with words such as approved, signed or authorised, and tells you why. Your new name shows on what you sign from now on. Anything you have already signed or approved, such as a site report signature or approval, a vehicle check or other check you filed, or a toolbox talk you acknowledged, keeps the name you had then. An owner's decision on safety documents does too, for decisions made after this update.
See your pay rate
On My account, under At work (on the web, it's on Details), you see your own hourly pay rate, or Not set. You can't change it. Your email, role and job title are there too, read only. Your owner or admin sets all of these, so ask them if something is wrong. Only you, the owner and admins can see your pay rate. My account doesn't show your cost and charge rates.
Your certificates, leave, timesheets and bonuses
The Certs, Leave, Timesheets and Bonuses tabs show the same records as their own pages, for you only. In the iPhone and iPad app they are the rows under Your records: My certificates and gear, My leave, My timesheet and My bonuses. See Certifications and qualifications, Leave, Your timesheet and Bonuses.
Choose light or dark
On the web and in the Android app, under Appearance on My account → Settings, select Light or Dark. In the iPhone app, use the Appearance row in More. Select System to follow the phone's light or dark setting, or select Light or Dark to use that appearance. The iPhone app saves the choice on that phone, and its My account screen has no Appearance section.
Change your password
- On the web, open My account → Settings. On iPhone, open My account, select Sign-in and security, then Password, two-step sign-in and passkeys, then Change password.
- On the web, select Change password to open the security drawer. Enter your current password, then your new one twice.
- Select Change password.
Your new password needs at least 8 characters and must be different from your current one. ONYX1 confirms with Password changed. You’ve been signed out everywhere else. Changing your password signs you out of every other device you were signed in on; this one stays signed in.
Turn on two-factor authentication
Two-factor authentication asks for a 6-digit code from an authenticator app each time you sign in, on top of your password.
- On the web, open My account → Settings → Two-factor authentication → Set up 2FA. On iPhone, open My account → Sign-in and security → Password, two-step sign-in and passkeys → Set up two-step sign-in.
- Confirm your password.
- Scan the QR code with an authenticator app such as Google Authenticator, or enter the printed key by hand if you can't scan it.
- Save the backup codes shown. They're shown once, and each one works once. The released iPhone app calls them Recovery codes.
- Enter the 6-digit code from your app and select Enable 2FA. In the released iPhone app the final button is Turn on two-step sign-in.
If your workspace requires two-factor authentication for everyone, ONYX1 sends you through these same steps before you can open anything else.
If you can't use your authenticator app
Use one of the backup codes you saved when you set up two-step sign-in.
- Sign in with your email and password.
- On the code screen, select Use a backup code. In the released iPhone app, select Use a recovery code.
- Enter one of your backup codes and select Verify. On the web, you can type it with or without the dash and spaces. In the released iPhone app, enter the code as shown, including its dash; the next iPhone build accepts it with or without the dash and spaces. Capital and small letters matter.
Each backup code works once, so cross it off. If a code is refused, check you are not using one that has already been used. After five wrong tries on one sign-in, ONYX1 sends you back to the password screen. After ten wrong codes in a row, code entry is paused for 15 minutes.
If you select Verify several times in a few seconds, ONYX1 says Too many tries. Wait a few seconds, then try the code again. This is not the 15-minute pause: your code stays in the box, so wait a few seconds and select Verify again. The released iPhone app shows the 15-minute message here instead and returns you to the password screen; the next iPhone build keeps you on the code screen.
If you have no backup codes left, ask an owner to reset your two-step sign-in. They open you on Team on the web, select Reset two-step sign-in and confirm it's them. The iPhone control is in the next iPhone build. You are signed out everywhere, ONYX1 tries to email you (if delivery fails, the owner must tell you), and you sign in with your password. If your workspace requires two-step sign-in, ONYX1 then asks you to set it up again. An owner can't reset their own two-step sign-in this way, so if you are the only owner and have no backup codes, email support@onyx1.app.
Owner passkeys
Only an owner can add a passkey, and two-step sign-in must already be enabled. Open Settings → Security and find Passkeys. Enter a name in Passkey name before selecting Add a passkey, then confirm with an authenticator code or backup code if ONYX1 asks. Passkeys work in supported browsers that provide WebAuthn and a platform authenticator. On iPhone, manage passkeys from My account → Sign-in and security → Password, two-step sign-in and passkeys: enter a Name for the new passkey (optional), then select Add a passkey on this iPhone. Passkeys may not work inside the ONYX1 Android app; use an authenticator or backup code there. An authenticator or backup code works everywhere if passkeys are unavailable or do not work.
A passkey (Face ID, Touch ID or Windows Hello on supported devices) can confirm that it is you when you open another person's request text in Office, in the iPhone app or a supported browser. You can still use an authenticator or backup code there. A passkey does not replace two-step sign-in and cannot sign you in; your password and second factor are still required at sign-in.
Signing in with two-factor on
After your email and password, ONYX1 asks for the 6-digit code from your authenticator app. Enter it and select Verify. If your phone's clock has drifted, the code may not match; check it's set correctly and try again.
Reset a forgotten password
- On the sign-in page, select Forgot password?.
- Enter your account email and select Email me a reset link.
- Open the email and follow the link within 1 hour. It works once.
- Set your new password and select Set new password.
ONYX1 shows the same message whether or not the email has an account, so it never reveals which emails are registered. If the link has expired or was already used, request a new one from the same page.
Connect your Microsoft 365
If your workspace has ONYX1 Office, My account → Settings also has a Microsoft 365 section. Select Connect Microsoft 365 and sign in to Microsoft with your own work account, which has to use the same email address as your ONYX1 sign-in. Microsoft asks which account to use, and one Microsoft account can be connected to one person in your workspace only. Once connected, the section shows the account and connected. If the connection expires, it shows needs reconnecting and a Reconnect button. If your older connection is missing calendar write access, it says Reconnect Microsoft 365 to let Office send invites. and shows Reconnect; reconnect and accept the updated Microsoft permission to create calendar invites. Disconnect removes your connection at any time. Every role can connect their own account. Nobody else can connect or use it. The owner and admins can see only that you have connected and which account. See Connect your Microsoft 365 for what it allows and what it does not keep.
Show the getting started tour again
On the web, My account → Settings has a Getting started tour section. Select Show the tour again to turn the checklist back on and go to Home. In the iPhone and iPad app, open More and select Show the getting started tour again, just below your profile row. See The getting started tour.
Show or hide Chippy
On the web and in the Android app, the Chippy section of My account → Settings has a Show Chippy switch. Turn it off to remove the Chippy button from every page, and turn it on to bring it back. It is on to start with, changes only your own account and stays with your account. The section shows only while Chippy is available. In the iPhone and iPad app, the same switch arrives in More with a later app update. See Ask Chippy, the ONYX1 assistant.
Delete your account
On the web, My account → Settings has Email a deletion request. To close your ONYX1 login altogether, or to ask what we hold about you, see Delete your account and data.
