Troubleshooting
What's actually happening behind common error messages and stuck states, and what to do about them
This page covers what's actually going on behind a handful of situations that look like something's broken but usually aren't. For everyday how-do-I questions, see Common Issues; for things that genuinely aren't built yet, see Known Gaps.
Signing in
Locked out after too many failed password attempts, or need to set up two-factor authentication and recovery codes? Both are covered in detail in Signing In and Authentication & Recovery Codes — the short version is that a lockout clears itself after a wait, and resetting your password clears it immediately without waiting.
A payroll run is stuck at "Paying out"
A run moves through Draft → In review → Approved → Processing → Paying out → Paid. "Processing" is a brief pass-through state right after you submit — you shouldn't see it for long. Paying out is different: it means the run has already been submitted and the checks or direct deposits are genuinely in motion — money is committed — and Greenroom is waiting on final confirmation before marking the run Paid.
Sitting at "Paying out" for a while is normal, not a sign of failure — Greenroom checks in on runs in this state on its own and moves them to Paid automatically once confirmation comes back, with no action needed from you.
If a run has been at Paying out for an unusually long time (hours, not minutes), don't assume it will resolve itself indefinitely — contact support with the run's code. There's currently no separate on-screen indicator that distinguishes "still settling normally" from "something went wrong on the payment side," so an unusually long wait is the signal to reach out rather than keep waiting.
A payroll run won't submit
If your company has Require a second approver turned on (Settings → Payroll approvals — this is the default), a run needs approval from two different people before it can be submitted, and neither of them can be the person who prepared it. A common trap: editing a run after it's been approved resets its approvals, so a run you thought was ready to go may need to be re-approved after a last-minute change. If you're running a one-person show, this setting can be turned off in Settings.
A payee won't show up as ready for payroll
Being payroll-ready and being onboarding-approved are two separate, both-required gates — a payee needs both before they can join a run. Hover the status dot on the payee list, or open the payee and check the What's left for payroll card, to see exactly what's outstanding. The hard requirements are:
- A pay rate on file (not required for vendors, who bill per invoice)
- Required documents collected (varies by payee type)
- Tax setup resolved
A missing or pending tax-withholding status shows as a non-blocking advisory ("tax pending") rather than something that blocks payroll — Check, not Greenroom, is the system of record for that. Also worth checking: an archived payee can't join a new run at all — restore them first if they need to be paid again.
"Already uses that email" when adding a payee
Each email address can only belong to one active payee per company. Adding a payee with an email that's already in use returns a message naming the existing payee and their payee code, so you can tell whether it's a genuine duplicate (open that payee instead) or a retry after an earlier attempt seemed to fail. If the original payee was archived, their email is free to reuse — archiving isn't a delete, but it does release the email.
A payee's onboarding link doesn't work
Onboarding links expire. Once one has, opening it shows "This link has expired — ask your company manager to re-send it." There's no self-service renewal — a company manager needs to open that payee's own page and send a fresh invite from there.
Bank or routing number rejected
Routing numbers aren't just checked for being 9 digits — they're checked against the actual bank routing-number checksum, so a plausible-looking but mistyped number is caught before it's saved ("That routing number doesn't pass the bank checksum — double-check it."). If you're confident the number is right and it's still rejected, double-check for a transposed digit rather than assuming the check itself is wrong.
Data seems to be missing
Almost always a filter. The payee list defaults to showing Active payees only — archived payees are hidden until you switch to the Archived view. Search, type tabs, and the Union/Onboarding filters all narrow the list further and stay applied until you clear them. See Filters and Search for the full list of what's filtering your view at any given time.
Getting help
When something needs a real person, email support@greenroompayroll.com. Include what you were trying to do, the exact error text if there was one, and the relevant payee code or run code — both are visible on their respective pages and make it much faster to look up what happened.
Next steps
See Common Issues for everyday questions, Known Gaps for functionality that isn't built yet, or Filters and Search if what you're looking for seems to have disappeared.