Billable
How billable times are configured and what they do
The billable
field determines if timesheet entries are included in invoices, budget calculations and statistics.
The API supports filtering by this field.
Permissions
Two permissions control the billable field access:
edit_billable_own_timesheet
- allows editing own timesheets (default: Teamlead, Administrator, System-Admin)edit_billable_other_timesheet
- allows editing other users’ timesheets (default: Teamlead, Administrator, System-Admin)
To hide the billable field, remove the corresponding permission from the user group.
Timesheet options
Users with billable permissions can choose between:
Yes
- timesheet is billableNo
- timesheet is not billableAutomatic
(default) - billable state is detected automatically
Configuration
The billable flag exists on three levels:
- Activity
- Project
- Customer
New entities are billable by default. Deactivate the billable
checkbox for non-billable entities (e.g. internal activities).
Automatic detection
New timesheets use Automatic
detection by default. The billable state is determined by checking:
- Activity billable flag
- Project billable flag
- Customer billable flag
A timesheet is only billable if all three entities are marked as billable. Users with edit_billable_own_timesheet
permission can manually override this.
Related articles
- Timesheet – View and manage your time-tracking data in the timesheet view
- Customer – Customers in Kimai
- Projects – Projects in Kimai
- Activities – Activities in Kimai