Projects in Kimai are assigned to customers and are linked to activities, which are then used for time-records.

Project colors

Each project can be assigned its own color, for easier identification in the timesheets.

If no color is applied, the customers color will be used.

If an activity linked to the project does not have its own color, the projects color will be used (and as fallback again the customers color).

See customer documentation for the default color.

Time budget

The Time budget field supports entering data in the following formats:

Format Description Examples
{hours}:{minutes}[:{seconds}] Seconds are optional, overflow is supported for every field 2:27 = 2 Hours, 27 Minutes / 3:143:13 = 5 Hours, 23 Minutes, 13 Seconds
{hours}h{minutes}m{seconds}s Each section is optional, overflow is supported for every field 2h = 2 Hours / 147m = 2 Hours, 27 Minutes / 3h14m13s = 3 Hours, 14 Minutes, 13 Seconds
{seconds}   3600 = 1 Hour / 8820 = 2 Hours, 27 Minutes

Time budgets are not used for hard limitations, but rather for the base of reporting calculations.


By toggling the visibility on a project, you:

  • hide the project from all drop-downs
  • hide the project from the default list in the project administration
  • hide the activities for this project from all drop-downs, regardless of their visibility state
  • hide the activities for this project from the default list in the activities administration

Please note:

  • all currently linked objects will still show the project in the dropdown as pre-selected option
    • you can still change the project on timesheet records and activities, which used it before
    • you cannot create new activities for this project
    • you cannot create new timesheet records for this project
  • you can still access the hidden entries by changing the visibility filter on the the toolbars

The visibility filter in the toolbar has three state:

  • Visible: Yes (all projects that are “really” visible, meaning: the project and linked customer are visible)
  • Visible: No (all projects that are exclusively invisible by their own visibility state)
  • Visible “empty” (all projects: not filtering on their own or the customers visibility)