Using the Upwork Time Tracker
How the desktop tracker works, what protection it gives you, and how to use it correctly on hourly contracts.
Why the time tracker matters
The Upwork time tracker is not just bookkeeping. Upwork's hourly payment protection only applies to hours logged via the desktop app tracker. Manually logged hours are explicitly not covered — if a client disputes manually logged time, Upwork will not enforce payment on your behalf.
This is the single most important thing to understand about hourly contracts: the tracker is your proof of work. Hours tracked through the app are protected. Hours not tracked through the app are not. No exceptions.
How it works
The Upwork desktop app takes random screenshots and logs keyboard and mouse activity levels every 10 minutes during tracked sessions. These entries make up your "work diary" — the record Upwork uses as evidence of work performed if a dispute arises.
Each 10-minute segment shows: a screenshot from somewhere in that window, an activity level percentage (based on keyboard and mouse input), and a memo you can attach to describe what you were working on. The client can view your work diary at any time.
If a dispute is raised, Upwork reviews the work diary alongside the contract description and message history. Tracked hours with reasonable activity levels and work that matches the scope are generally covered.
Getting set up
Download the Upwork desktop app from Upwork's website. The setup is straightforward:
- Install the desktop app on your primary work machine.
- Log in with your Upwork credentials.
- When you start work, open the app and select the correct contract (you may have multiple active contracts — always verify before starting).
- Start the tracking session. The app runs in the background and takes screenshots automatically.
- Stop the session when you stop working. The tracker does not stop automatically.
The app shows you hours logged, earnings accrued for the current billing week, and a preview of recent screenshots. Check it periodically to make sure it's running and logging correctly.
Work diary visibility
Your client can see your work diary — screenshots, activity levels, and memos. This is intentional transparency built into how Upwork's hourly protection works. The tradeoff is: in exchange for payment protection, Upwork's evidence of your work is visible to the client paying for it.
Be aware of this. Screenshots showing extended idle periods, work on unrelated tasks, or content the client might find odd can create friction. You don't need to perform for the camera, but being genuinely working when the tracker is running is both what you're billing for and what keeps your work diary clean.
Adding memos to your 10-minute segments helps clients understand what they're seeing. "Researching competitor pricing" or "Writing section 3 of the report" gives context that a screenshot alone might not convey.
Manual time logging
Upwork allows you to log time manually — time not captured by the desktop app. Manual hours are not covered by payment protection. If you log manual time and a client disputes it, Upwork will not enforce payment.
Some clients allow manual time for offline work — site visits, phone calls, whiteboarding sessions that can't be tracked on a computer. If you'll need to log manual time, confirm this with your client explicitly in advance and document their agreement in the Upwork message thread. Manual time appears separately in the work diary and is visible as such.
Weekly billing cycle
Hours logged Sunday to Saturday (midnight to midnight) are billed to the client the following Tuesday. Payment becomes available to you approximately 5 days after that, provided the client doesn't dispute the hours. Clients have a window after billing to review the work diary and raise a dispute before funds clear.
Understanding this cycle helps with cash flow planning, especially when starting a new hourly contract. Your first week of work won't pay out for roughly 10–12 days.
Hourly limits
You can set a weekly hour limit per contract — a ceiling on hours you'll log in a given week. Clients can also set a maximum. If you exceed the client's weekly limit, hours over the limit are logged in the work diary but Upwork does not guarantee payment on them. Hours beyond the agreed limit are at the client's discretion to approve or decline.
Always track against the agreed limit. If you anticipate needing more hours in a given week, communicate with the client in advance and get their written approval in the Upwork message thread before logging the extra time.