Help / Clients & projects

Project billing types

Every project has a billing type that decides whether and how its tracked time turns into money. You set it when you create the project and can change it later on the project's Edit page. Projects are managed by managers, admins, and owners; members track time against them but do not configure billing.

The five billing types

When you select + New project, the billing dropdown offers five choices:

  • Hourly — person rates — each person bills at their own rate, so a senior and a junior on the same project bill differently.
  • Hourly — project rate — every hour on the project bills at one flat rate you set here.
  • Hourly — task rates — the rate depends on the task, so design hours and development hours can bill differently.
  • Fixed fee — you bill a set price regardless of how many hours are tracked.
  • Non-billable — the work is tracked but never billed to a client.

On a project's Edit page the same choices are grouped under three Project type cards. Time & Materials ("Bill by the hour, with billable rates") covers the three hourly variants, and a Rates come from dropdown then lets you pick Person rates (per-person overrides), One project rate, or Task rates. The other two cards are Fixed Fee ("Bill a set price, regardless of time tracked") and Non-Billable ("Not billed to a client"). For a fixed-fee project you enter the Project fees — the amount you plan to invoice.

How fixed-fee revenue is counted

On reports, a fixed-fee project's revenue is its fee spread over the billable hours logged to it. Each billable hour earns the fee divided by the project's total billable hours, counted across all time — not just the period you are looking at. So with a fee of 10,000 and 40 hours logged, each hour is worth 250: a month with 10 of those hours shows 2,500, and the people, tasks and months add up to the fee.

Three things follow from this:

  • The figure moves as hours are logged. Logging another 10 hours makes each hour worth 200, so last month's 10 hours now show 2,000. The project as a whole still earns exactly its fee; only the split between periods and people changes.
  • Non-billable and deleted time is left out, both from what earns a share and from the total it is divided by.
  • A fixed-fee project with no fee set earns 0, and the Profitability report, the report builder and the project page say no fee set beside it rather than pricing its hours at hourly rates. Enter the fee on the project's Edit page.

Cost is not affected: every hour still costs what the person's cost rate says. This applies to Profitability, the report builder (including saved reports), the REST API's time reports and the assistant, so they all show the same figure. Invoicing is unchanged: uninvoiced amounts and drafted invoices still price fixed-fee time at hourly rates, so check the amounts before you send one.

Setting it through the API or the assistant

The billing type and the fixed fee can also be set without opening the Edit page. As there, only managers, admins, and owners can change them, or a REST organization API key with write access.

  • REST API. POST /api/v1/projects and PATCH /api/v1/projects/{id} accept billing_type (hourly_project_rate, hourly_person_rate, hourly_task_rate, fixed_fee or non_billable) and fixed_fee. Every project response includes both. They are empty for a member's personal token, as other money fields are.
  • The assistant, and Claude through the connector. Ask "make Acme Rebrand a fixed-fee project at 12,000". "What is the fee on Acme Rebrand?" is answered too.

Two rules apply on every route:

  • A fee needs a fixed-fee project. Sending a fee for a project that bills hourly or not at all is refused, and nothing is changed. A fee there would do nothing. Send the fixed-fee billing type in the same request.
  • Changing a fixed-fee project to another type keeps its fee, as the Edit page does, so switching back restores it. To remove the fee, clear it explicitly.

Through Claude's connector, an organization API key can read these settings but not change them, because a connector on an organization key is read-only. To change them from Claude, connect by signing in, or use a personal access token. Over REST, an organization key with write access can change them.

Where rates come from

For hourly projects, Time Trakkr decides the rate for each time entry by working down a chain and using the first rate it finds. From most specific to least:

  1. The entry's own rate — the rate captured on the time entry itself. Because it is snapshotted onto the entry, an entry keeps the rate it had even if you change rates later.
  2. The person's project rate — a per-person override set on the project's Team section.
  3. The task's rate — the rate set on the task.
  4. The project rate — the single hourly rate on the project.
  5. The person's default rate — their workspace default billable rate.

This is why the billing type mainly changes which link in the chain does the work: person rates lean on step 2, task rates on step 3, and a single project rate on step 4. If no rate is found anywhere, the entry bills at zero. Only managers, admins, and owners ever see these rates; members never see money, as described in roles and permissions.

Setting per-person and per-task rates

Open a project and go to its Edit page:

  • In the Team section, each person has a rate control. Select Apply custom rate to give that person a project-specific rate; otherwise their default applies.
  • In the Tasks section, each task carries its own rate and a Billable checkbox. That checkbox decides whether time logged against the task is billable — there is no per-entry override, so the answer is the same for everyone and cannot be changed while tracking. A non-billable project overrides its tasks, since its work is never billed at all. Changing it here changes it for all new time; entries already recorded keep the value they were saved with.

When earlier entries disagree with their task

If a task's Billable box is changed after time was logged to it, the earlier entries still carry the old answer. The project page then shows a Billable / Non-billable split that disagrees with its task tables, and a project that counts only billable hours against its budget counts the wrong ones.

The Tasks section says so, task by task: how many earlier entries are still marked the other way and how many hours they hold. Choose Make N entries non-billable (or billable) to bring them in line, or Leave them to keep them as recorded. Nothing changes unless you choose it.

  • It changes everyone's entries on that task, so only managers, admins and owners can do it.
  • Approved or invoiced entries never change. They keep the answer they were approved or billed with, and the message says how many there are.
  • A non-billable project still wins: nothing on it becomes billable.

The assistant can do the same: ask it which tasks have entries that disagree with their billable setting, or to make a task non-billable and apply that to its existing entries. Task rates are seeded from the task library when you add a task, and you can adjust them per project.

Project code and dates

Two optional fields on the Edit page help you organize and report on a project:

  • Project code — a short identifier of your own, useful for matching Time Trakkr projects to codes in another system.
  • Start date and planned end date — both optional, and shown on the project page under its name. They are for planning, not a lock: time can still be tracked before the start or after the planned end. Once an active project is past its planned end, the project page says so. The assistant can read both, and the API returns them as starts_on and ends_on.

To set budgets and alerts on top of a project's billing, see budgets.

Updated 2026-11-04. Still stuck? Contact support or return to the Help Center.