> ## Documentation Index
> Fetch the complete documentation index at: https://docs.soundchecklive.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Time clock and timesheets

> Crew clock in and out of a gig on their phone. You review, fix and approve their hours, approved hours set hourly pay, and you export them for payroll. Early access.

Hours are where staffing turns into money. An hourly stagehand who stays two hours past the out time is owed for them, and you need a clean record before you pay or bill anyone. Soundcheck's time clock lets crew clock in and out of a gig on their phone. You then review, fix and approve their hours, approved hours set hourly pay, and you export them for payroll.

![Crew hours on a gig with the On the clock, Not in yet, Clocked out, Needs review and Approved counts and a clocked shift waiting for review](https://mintcdn.com/soundchecklive/e-SmuOY4KzOPmXhu/images/finances/crew-hours-light.png?fit=max\&auto=format\&n=e-SmuOY4KzOPmXhu\&q=85\&s=ff6b1a5b34f7df2fdd7784997ea130fd)

> [!NOTE]
>
> **Early access.** The time clock is rolling out to organizations gradually. Contact [info@soundchecklive.io](mailto:info@soundchecklive.io) if you'd like it turned on for yours. Once it's on, an owner or admin still has to switch on clock-in in settings. It's off by default.

## When to use it

* **Hourly crew.** Turn it on when you pay crew by the hour. Approved hours replace the scheduled hours on their pay.
* **Day-rate crew you want a record of.** Turn on **Fixed-rate crew clock in too** to record when flat-rate crew arrive and leave. Their hours are recorded but don't change their pay.
* **Payroll hand-off.** When a payroll provider or bookkeeper pays your crew, export the approved hours instead of re-typing them.

If everyone on your gigs is paid a flat fee and you don't need arrival times, you can leave the time clock off.

## How it works

**1. An admin turns it on**

An owner or admin sets the rules once for the whole organization: clock-in, location, meal breaks and overtime.

**2. Crew clock in on their phone**

From two hours before their call, crew booked on the gig tap **Clock in** in the mobile app, then **Clock out** when they're done.

**3. You review and approve**

Their entries land on the gig's **Finances** tab under **Crew hours**, and across gigs on the **Timesheets** tab. You fix mistakes and approve.

**4. Approved hours set pay**

On an hourly shift, the approved hours replace the scheduled hours, with any overtime you've set up. The payable updates on its own.

**5. Export for payroll**

**Export approved hours** downloads a CSV for your payroll provider. Soundcheck doesn't run payroll itself.

## Turn on the time clock

**1. Open the settings**

On the web, go to **Settings → Organization → Gig workflow** and find the **Time clock** card. It reads: *Let crew clock in and out from the Soundcheck app. Hours are exported for payroll; nothing is paid automatically.*

**2. Turn on clock-in**

Switch on **Crew clock in and out**. Hourly crew offers and accepted invitations then get a clock on the gig's work day. While it's off, the other settings read *Turn on clock-in to change these.*

**3. Choose the rest**

Set the options in the table below. Each one saves as you change it.

| Setting | What it does |
| - | - |
| **Crew clock in and out** | The main switch. Off by default. |
| **Fixed-rate crew clock in too** | Lets crew on flat-rate shifts clock in as well. Crew offer days only. Their hours are recorded but don't change their pay. Without it, they see *Your pay on this gig is a fixed fee, so you don't clock in for it.* |
| **Record location at clock-in** | Asks crew for location and flags entries more than 400 m from the venue. It never blocks clock-in. |
| **Meal breaks** | Crew enter how long their meal break was, in 15-minute steps. On by default. |
| **Meal breaks are** | **Unpaid** or **Paid**. Unpaid meal time is left out of worked hours. Unpaid by default. |
| **Overtime on hourly shifts** | Daily overtime and double time thresholds and multipliers. See [Overtime and union rules](https://docs.soundchecklive.io/features/gigs/staffing/overtime-and-union.md). |

Only owners and admins can change these settings, and only on the web. To turn clock-in off, confirm **Turn off clock-in?**. Anyone on the clock can still clock out, and you can still review, approve and export hours already recorded.

## Clocking in and out on mobile

Crew clock in from the gig in the Soundcheck app. **Crew can't clock in on the web.**

**1. Wait for the window**

Before the window opens, the gig's **Time clock** card says **Clock-in opens at** a time two hours before their call. Crew Home and the top of the Gigs list show a **Clock in for** row that opens the gig.

**2. Clock in**

Tap **Clock in** in the gig's bottom bar. With location on, the app first shows **Finding your location…**. If it can't get a location, it clocks in anyway with *Clocked in without location*.

**3. Log the meal break**

With **Meal breaks** on, use the meal stepper on the card, in 15-minute steps.

**4. Clock out**

Tap **Clock out**. The **Clock out at** sheet shows the meal stepper again. Choose **Clock out**, or **Not yet** to keep working. The entry then reads **Pending approval**.

A few things crew run into:

* **Two calls in one day.** After clocking out, **Clock in again** starts a second entry for the same day, such as load-in and then the show.
* **Forgot to clock out.** Tap **I forgot to clock out** and answer **When did you stop working?** with a time after clock-in. **Save stop time** closes the entry and marks it as reported by them. Once the work day is over, the bar reads **Still clocked in** with **Set my stop time**.
* **Clocked in elsewhere.** Someone can't be on two clocks at once: *You're clocked in to another gig. Clock out there first.*
* **No signal.** In a basement or an arena bowl, the punch is kept on the phone: *Saved on this phone. Will sync when you're back online.* It sends once they reconnect.
* **Their own record.** **You → My schedule → My hours** shows their hours for **This week**, **Last week** and **30 days**, with each entry's status. Approved entries show who approved them and the approved pay. Pending hours show an estimate.

### When a punch is refused

A refused clock-in, clock-out or added entry always says why. Crew see the reason in the app; managers see it on the web and in the app when they clock someone in or out or add time.

| Reason | What to do |
| - | - |
| Clock-in is off for the organization | An admin turns on **Crew clock in and out**, or a manager adds the time. |
| The gig is cancelled, archived or not published | Nobody clocks in. Add the time if it was worked. |
| The person isn't crew on the gig | Book them on a shift first. |
| The shift isn't one the person accepted | Pick one of their own shifts. |
| A fixed-rate shift while **Fixed-rate crew clock in too** is off | Turn the setting on, or add the time. |
| Before the window opens, after it closes, or no shift that day | Wait for the window, or add the time on the day worked. |
| Already clocked in, or not clocked in | Clock out of the other entry first, or clock in first. |
| The hours overlap another entry | Fix or reject that entry first. |
| A time in the future | Check the phone's clock, or pick a time that has passed. |
| The entry changed since it was opened | Review it again. |
| A meal break while meal breaks are off, or longer than the time worked | Turn meal breaks on, or shorten the meal. |
| A clock-out before the clock-in | Pick a later time. |

## Review and approve hours

Hours show in two places:

* **One gig:** the gig's **Finances** tab, under **Crew hours**. Counts show who is **On the clock**, **Not in yet**, **Clocked out**, **Needs review** and **Approved**.
* **Every gig:** the **Timesheets** tab on the **Crew** page, this week by default, with **Gig**, **Person**, **Status** and **Exception** filters. Organizations that don't use crew staffing find **Timesheets** in the sidebar instead.

Each entry shows the scheduled time, the in and out times, the meal, the hours worked, the difference from schedule, any exceptions and its status (**Clocked in**, **Pending approval**, **Approved** or **Rejected**).

### Exceptions

Soundcheck flags entries that need a second look. Three of them block approval until you fix the entry.

| Exception | What it means | Blocks approval |
| - | - | - |
| **Missing clock-out** | The person never clocked out. | Yes |
| **Over 16 hours** | The entry runs longer than 16 hours. | Yes |
| **Duplicate** | It repeats another entry. | Yes |
| **Early** / **Late** | Clocked in before or after the call. | No |
| **Hours differ from schedule** | Worked hours differ from the scheduled call to out. | No |
| **Outside venue** | Clocked in more than 400 m from the venue. | No |
| **Self-reported** | The person entered their own stop time. | No |
| **Edited after approval** | Someone changed it after it was approved. | No |
| **Device time mismatch** / **New device** | The phone's clock was off, or it's a phone they haven't used before. | No |

### Fix and approve

| Action | What it does |
| - | - |
| **Edit time** | Changes a clock-in or clock-out. A reason is required, and the change shows in **Edit history**. |
| **Set clock-out** | Closes an entry someone forgot to clock out of. |
| **Add time** | Adds an entry for someone who didn't clock in, such as a walk-up hire without the app. It's marked as added by a manager. |
| **Approve** | Approves the entry. **Approve and next** moves to the next person. |
| **Approve selected** | Approves every ticked row. Blocked entries and your own are skipped. |
| **Reject…** | Rejects the entry with a reason the crew member sees. |
| **Reopen** | Sends an approved or rejected entry back to review. |

On mobile, managers open the gig, tap **More**, then **Finances**, and find **Crew hours**. They can **Fix a time**, **Reject with a reason**, **Reopen**, **Add time**, and tap **Approve N ready** to approve everything that's ready. Approving needs a connection.

> [!WARNING]
>
> Nobody can approve their own hours. If two people review the same entry, the second sees *This entry changed since you opened it. Review it again.*

## Who can see, fix and approve hours

| Who | Sees | Can do |
| - | - | - |
| Owner, Admin, Finance | Times and amounts | Edit, approve, export |
| Gig Coordinator | Times only | Edit times, without seeing pay |
| Gig **Lead** assignment | Times and amounts on that gig | Edit and approve |
| Gig **Finances** assignment | Times and amounts on that gig | View only |

Archived gigs are view only. See [Permissions and privacy](https://docs.soundchecklive.io/features/gigs/staffing/permissions-and-privacy.md).

## How approved hours change pay

On an **hourly** shift, pay starts from the scheduled call-to-out hours. Approved hours then take over:

* **A day is settled once every entry on it is approved or rejected.** Its payable then uses the whole minutes worked, minus an unpaid meal break, times the rate, plus any [overtime](https://docs.soundchecklive.io/features/gigs/staffing/overtime-and-union.md). It's rounded to the cent.
* **Still in review.** While any entry on the day is waiting, the payable stays on scheduled hours.
* **Reopened.** Reopening an approved day whose payable is unpaid puts it back on scheduled hours.
* **Already paid.** Approving more hours on a paid day leaves the paid line alone. A new unpaid line holds the difference.
* **No rate.** Hours approved for someone with no hourly rate show a **No rate** badge.

Flat-rate shifts and invitation crew keep their fixed fee whatever the clock says. A day-rate person is paid their day rate for each accepted day, and clocked hours never change it. Day-rate crew only get a clock when **Fixed-rate crew clock in too** is on. See [Pay and rates](https://docs.soundchecklive.io/features/gigs/staffing/pay-and-rates.md).

### Day-rate crew

* **Clocking in.** Day-rate crew only clock in when **Fixed-rate crew clock in too** is on. Turn it on if you want a record of when they arrive and leave.
* **Pay stays fixed.** A day-rate person is paid their day rate for each accepted day. Approving, fixing or rejecting their hours never changes it, and there is no overtime on a day rate.
* **Days to decide on.** An accepted day that ended with no clock-in, or whose hours were all rejected, is flagged under **Timesheets** as needing a decision, with the day's pay. Nothing is voided automatically. To stop paying for the day, drop it from the person's crew offer; the accepted days set the pay. Hourly shifts with no clock-in are flagged the same way.

## Export hours for payroll

On the **Timesheets** tab, choose **Export approved hours**, then **CSV for payroll** or **PDF timesheet**. Both hold the same approved entries for the week and the **Gig** and **Person** filters you picked, so their totals always match. Exporting needs finance access. A gig's **Finances → Crew hours** has the same menu for that gig.

### CSV for payroll

One row per approved entry, for payroll imports. The columns don't change. The CSV lists approved hours only: days with no clock-in and rejected hours are flagged in the PDF timesheet and on the **Timesheets** tab, not here.

`amount` is filled in for:

* **Hourly** entries: the hours worked at the rate, with overtime and double time.
* **Day-rate** entries: the day rate, once per worked day. A second entry on the same day has no amount. `hourly_rate` stays blank and `pay_type` is `FIXED`.
* **Per-day fees**, when every day of the crew offer has its own fee: that day's fee, once per worked day.

A fixed fee typed for a whole multi-day shift has no per-day split, and neither does an offer where only some days have their own fee, so those entries have no amount. Pay them from the gig's ledger.

| Column group | Columns |
| - | - |
| Who and where | `person`, `role`, `gig`, `work_day`, `worker_email`, `worker_user_id`, `gig_id`, `punch_id` |
| Time | `clock_in_utc`, `clock_out_utc`, `clock_in_local`, `clock_out_local`, `time_zone`, `meal_minutes`, `worked_minutes` |
| Overtime | `overtime_minutes`, `doubletime_minutes` |
| Pay | `pay_type`, `hourly_rate`, `amount`, `currency`, `missing_rate` |
| Approval | `approved_by`, `approved_at_utc`, `approved_at_local` |

Local times use the gig's time zone, so a tour across zones exports correctly. Most payroll tools (ADP, Gusto, QuickBooks Payroll and others) take a CSV import. Soundcheck doesn't connect to them directly. See [Crew invoices and payouts](https://docs.soundchecklive.io/features/gigs/staffing/crew-invoices-and-payouts.md).

### PDF timesheet

A branded PDF for people: to review, sign off, or send to crew or a client.

* **Header**: your logo and colors, the period, the gig (or **All gigs**), the person if you filtered one, and when it was made, in your organization's time zone (the gig's, for one gig).
* **Summary**: one line per person with their roles, hours, overtime, double time and amount, then a **Grand total**.
* **Detail**: grouped by person, then by role, so someone who worked A2 one day and A3 the next gets a table for each. Each entry shows the work day, gig, local clock-in and clock-out, meal, worked, regular, overtime and double-time hours, rate, amount, pay type and who approved it. Each role ends with a subtotal, and a person with more than one role gets a total.
* **Flags**: **Missing rate** on hourly entries with no rate, and **Gig deleted** on hours from a deleted gig.
* **Waiting for approval, not in totals**: entries still on the clock or unapproved for the same filters, listed so nothing is missed. They aren't counted.
* **Needs a decision, not in totals**: accepted days with no clock-in after the day ended, and days whose hours were all rejected, with the person, role, gig, day and the pay at stake. They aren't counted.

Amounts are the same as the CSV's `amount` column: hourly pay with overtime and double time, and the day rate once per worked day (shown as a rate per day). A whole-shift fixed fee shows **Fixed** with no amount. Long timesheets run over several pages with the column headings repeated.

## What the time clock doesn't do

Soundcheck doesn't do these today. Here's what to do instead.

| You want | Workaround |
| - | - |
| A crew chief clocking in the whole crew, or a shared kiosk tablet | Each person clocks in on their own phone. For crew without the app, the chief or a manager uses **Add time** after the call. |
| Clock-in on the web | Use the mobile app, or **Add time** on the web. |
| Block clock-in outside the venue | Location only flags entries **Outside venue**. Review those before approving. |
| Rounding to the quarter hour or to a minimum call | Pay uses whole minutes worked. Keep the real times, and add a **Member payout** line for the difference. See [Overtime and union rules](https://docs.soundchecklive.io/features/gigs/staffing/overtime-and-union.md#minimum-calls). |
| Flag a late or missed meal | Meal minutes are recorded and exported, but there's no meal-penalty rule. Check `meal_minutes` in the export. |
| Separate travel time from work time | Give travel its own shift, so it has its own entries. |
| Client sign-off on hours on site | Export the **PDF timesheet** for the gig and send it to the client. |
| Alerts when someone is about to hit overtime | Watch **On the clock** on the gig's **Crew hours**. |
| Weekly hour totals per person | Total `worked_minutes` per person in the export. |
| Crew dispute their hours in the app | Crew see the reason when you reject an entry. Other disputes go through you, and every fix needs a reason in **Edit history**. |

## Worked example: an AV company's hotel general session

Northline AV staffs a two-day corporate general session in a hotel ballroom. The A1 and V1 are on day rates. Eight stagehands are hourly, at a rate set on each person's position.

1. An admin turns on **Crew clock in and out** and **Record location at clock-in**. The stagehands' rates are hourly, so they clock in. The A1 and V1 are on flat shifts, so the admin also turns on **Fixed-rate crew clock in too** to see when they arrive.
2. On load-in day, the stagehands clock in from the loading dock. One clocks in from the parking garage across the street, and the entry shows **Outside venue**.
3. The load-out runs long. One stagehand forgets to clock out and uses **I forgot to clock out** the next morning, so the entry shows **Self-reported**.
4. The production manager, who has the gig's **Lead** assignment, opens **Crew hours**, checks the flagged entries, and uses **Approve selected** for the rest.
5. Approved hours replace the scheduled hours on each stagehand's payable. The office manager, who has the Finance role, exports approved hours for the week and imports the CSV into payroll.

## Questions this page answers

* Can crew clock in and out on their phone, and can I limit it to the venue?
* Can the crew chief clock in the whole crew at once, or use a kiosk?
* Can crew log meal breaks, and does the tool flag a missed meal?
* How do I fix a missed punch, and is the change logged?
* Who approves timesheets?
* Does time round to the quarter hour or to a minimum call?
* Can I enter time for crew who don't use the app?
* Can I export hours to payroll?

More answers in the [Staffing FAQ](https://docs.soundchecklive.io/features/gigs/staffing/faq.md).

## Related

> [card] [Overtime and union rules](https://docs.soundchecklive.io/features/gigs/staffing/overtime-and-union.md)
>
> Daily overtime and double time on approved hours.

> [card] [Pay and rates](https://docs.soundchecklive.io/features/gigs/staffing/pay-and-rates.md)
>
> How hourly and flat pay are worked out.

> [card] [Crew hours on a gig](https://docs.soundchecklive.io/features/gigs/finances/crew-hours.md)
>
> The Crew hours section of the Finances tab.

> [card] [Crew invoices and payouts](https://docs.soundchecklive.io/features/gigs/staffing/crew-invoices-and-payouts.md)
>
> Pay the hours once they're approved.

> [card] [Day of show](https://docs.soundchecklive.io/features/gigs/staffing/day-of-show.md)
>
> Running the call on the day.

> [card] [Permissions and privacy](https://docs.soundchecklive.io/features/gigs/staffing/permissions-and-privacy.md)
>
> Who sees hours and pay.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.