# Time Tracking Troubleshooting {#time-tracking-troubleshooting}


Resolve time tracking, timer, and timesheet issues.


## Timer Won't Start {#timer-wont-start}


**Fixes:**

1. Check the employee has the `TIME_TRACKER` permission
2. Verify a project/task is selected (if required by org settings)
3. Check the desktop app is connected to the API
4. Verify the employee account is active


## Time Not Syncing {#time-not-syncing}


**Symptom:** Desktop timer shows time but API doesn't

**Fixes:**

1. Check internet connectivity
2. Verify `API_BASE_URL` in desktop app settings
3. Check API logs for sync errors
4. Restart the desktop app


## Screenshots Not Capturing {#screenshots-not-capturing}


**Fixes:**

1. Check screenshot feature is enabled in org settings
2. Verify screen recording permissions (macOS: System Preferences → Privacy)
3. Check screenshot storage provider is configured


## Timesheet Approval Issues {#timesheet-approval-issues}


**Fixes:**

1. Verify approver has `CAN_APPROVE_TIMESHEET` permission
2. Check timesheet status is `PENDING`
3. Verify timesheet period covers the correct dates


## Duplicate Time Entries {#duplicate-time-entries}


**Cause:** Timer started multiple times.

**Fix:** Stop and delete duplicate entries, then restart timer.


## Related Pages {#related-pages}


- [Time Tracking](https://sourcey-gauzy.pages.dev/features/time-tracking/index.md) — feature guide
- [Time Tracking Endpoints](https://sourcey-gauzy.pages.dev/api/time-tracking-endpoints/index.md) — API reference
- [Desktop Timer](https://sourcey-gauzy.pages.dev/desktop/desktop-timer/index.md) — desktop app