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

# Timecards

> Read your TimeTracker timecard – worked, break, scheduled and variance per day – and correct shift times, add a missed shift or remove a mistaken one.

A timecard is your attendance for one period, one row per day. It shows what you
worked, what you were scheduled for, and the gap between the two.

## Where to find it

<Steps>
  <Step title="Open Time">
    Click **Time** in the sidebar.
  </Step>

  <Step title="Switch to the Timecards tab">
    The tabs read **Timesheets** and **Timecards**. The second only appears when
    the Time Clock app is on and you can see timecards.
  </Step>

  <Step title="Move to the period you want">
    Use the arrows, the period label, or **Today**. The period length matches your
    workspace's timesheet period – weekly, biweekly or monthly.
  </Step>
</Steps>

To see someone else's, pick them in the member picker at the top right. You need
`timecard.manage` or `timecard.approve`.

## The columns

| Column        | What it shows                                                          |
| ------------- | ---------------------------------------------------------------------- |
| **Day**       | The calendar date.                                                     |
| **In**        | The first clock-in of the day.                                         |
| **Out**       | The last clock-out. Reads **running** while a session is open.         |
| **Worked**    | Total of all closed sessions.                                          |
| **Break**     | Total of the gaps between sessions.                                    |
| **Scheduled** | Expected minutes from your work schedule.                              |
| **Variance**  | Worked minus scheduled, as `+1h 15m` or `−39m`. Negative shows in red. |
| **Status**    | The day's classification.                                              |
| ⋯             | The row menu.                                                          |

A dash means there is nothing to show for that day.

## The day statuses

| Status                | Meaning                                                          |
| --------------------- | ---------------------------------------------------------------- |
| **Present**           | You worked your scheduled day, within the grace window.          |
| **Late**              | Your first clock-in was after the scheduled start, beyond grace. |
| **Left early**        | Your last clock-out was before the scheduled end, beyond grace.  |
| **Over scheduled**    | You worked more than the day expected, beyond grace.             |
| **Absent**            | You were scheduled to work and never clocked in.                 |
| **Worked on day off** | You clocked in on a non-working day.                             |
| **Unscheduled**       | You clocked in but no schedule resolved for you.                 |
| **Incomplete**        | A session is still open for that day.                            |

A day can carry more than one. The most decision-worthy one is shown as the main
badge and the rest sit beside it.

Two extra badges can appear:

* **Approved** – the period has been approved, so the day is read-only.
* **Fix** – a session on that day was flagged for a missing clock-out.

Full detail on how these are decided:
[Absence and expected hours](/time-clock/absence-and-expected-hours).

## Correct a day

<Steps>
  <Step title="Open the row menu">
    Click the ⋯ at the end of the day's row.
  </Step>

  <Step title="Choose Edit times">
    A dialog opens, titled **Edit times · 2026-07-14**.
  </Step>

  <Step title="Adjust the shifts">
    Each shift is a pair of time fields – clock in, then clock out. Retype either
    one. The change saves as you go.
  </Step>

  <Step title="Add or remove shifts">
    **Add shift** creates a new one, pre-filled 09:00 to 17:00. The bin icon
    removes a shift.
  </Step>

  <Step title="Click Done">
    The day recomputes from the new times.
  </Step>
</Steps>

The dialog explains itself: "Adjust clock-in / clock-out times. The gaps between
shifts are the breaks; the day recomputes on every change."

<Note>
  There is no separate break control. Breaks come from the gaps between shifts.
  Move a clock-out earlier and the following break gets longer.
</Note>

### Deleting a shift

The bin icon asks first:

> **Delete this shift?**
> The shift is removed and the day's totals recompute. This can't be undone.

Click **Delete shift** to confirm.

## What is refused

| Message                                                                                      | Why                                                                                |
| -------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| "That clock-out lands before the clock-in. Check the time and try again."                    | The out time is at or before the in time.                                          |
| "That overlaps a session you already have that day. Adjust the times so they don't collide." | Two shifts would share the same minutes.                                           |
| A locked-period message                                                                      | The day sits inside a submitted or approved timecard. Withdraw or reopen it first. |

<Warning>
  Once a period is **submitted** or **approved**, its days stop recalculating and
  its shifts cannot be edited. That is the record the approver signed off on.
  Withdraw the submission or ask for a reopen.
</Warning>

## Example

Jonas Bergman forgot to clock in on Wednesday morning – he only clocked in after
lunch.

His timecard shows:

| Day        | In    | Out   | Worked | Break | Scheduled | Variance | Status |
| ---------- | ----- | ----- | ------ | ----- | --------- | -------- | ------ |
| Wed 15 Jul | 13:30 | 17:30 | 4h     | –     | 8h        | −4h      | Late   |

1. He opens the row menu and clicks **Edit times**.
2. The existing shift is `13:30 – 17:30`. He clicks **Add shift**, which creates
   `09:00 – 17:00`, then edits it to `09:00 – 13:00`.
3. He clicks **Done**.

The day now reads **Worked 8h**, **Break 30m**, **Variance 0**, **Status
Present**.

## Empty states

| What you see                                                                        | Why                                             |
| ----------------------------------------------------------------------------------- | ----------------------------------------------- |
| **No timecard this period** with "Clock in from the header to start a timecard."    | You have not clocked in during this period.     |
| **No timecard this period** with "This member hasn't clocked any time this period." | You are viewing someone who has not clocked in. |

## Permissions

| Action                      | You need                                |
| --------------------------- | --------------------------------------- |
| See your own timecard       | `timecard.view`                         |
| Edit your own shifts        | `timecard.clock`                        |
| See someone else's timecard | `timecard.manage` or `timecard.approve` |
| Edit someone else's shifts  | `timecard.manage`                       |

Owner, Admin, Project Manager, Finance, Member and Contractor can read and correct
their own. Only Owner, Admin and Project Manager can touch someone else's – and
only for people inside their supervision scope.

## What happens next

Every change recomputes that day's worked minutes, break minutes, variance and
status right away. Once the period looks right, submit it – see
[Submit a timecard](/time-clock/submit-a-timecard).

## Common questions

<AccordionGroup>
  <Accordion title="Why does Scheduled show a dash?">
    No schedule resolved for you on that date. The day will read **Unscheduled**.
    Ask an admin to assign you a schedule.
  </Accordion>

  <Accordion title="Why is Out showing “running”?">
    A session is still open. Clock out, or fix the time in **Edit times**.
  </Accordion>

  <Accordion title="Does a timecard affect my timesheet?">
    No. They are separate records. A timecard never creates a time entry and never
    reaches a project or an invoice.
  </Accordion>

  <Accordion title="Are breaks deducted from Scheduled?">
    No. **Scheduled** is the gross scheduled time for the day. Breaks are shown in
    their own column and are already excluded from **Worked**.
  </Accordion>

  <Accordion title="Can I edit a day in a closed period?">
    No. Submitted and approved periods are frozen. Withdraw your submission, or
    ask an owner or admin to reopen it.
  </Accordion>
</AccordionGroup>

## Related guides

<CardGroup cols={2}>
  <Card title="Clock in and out" icon="clock" href="/time-clock/clock-in-and-out">
    Day-to-day use of the clock button.
  </Card>

  <Card title="Submit a timecard" icon="paper-plane" href="/time-clock/submit-a-timecard">
    Send a period for approval.
  </Card>

  <Card title="Absence and expected hours" icon="calendar-check" href="/time-clock/absence-and-expected-hours">
    How each status is decided.
  </Card>

  <Card title="Missing clock-out" icon="triangle-exclamation" href="/time-clock/missing-clock-out">
    Fixing a session left open.
  </Card>
</CardGroup>