Skip to documentation content

Documentation · Process

Gantt chart

Name the unit, open a section, then list its tasks: each starts in a unit or after other tasks, and lasts a whole number of units.

Open Gantt chart

When to use it

Plan work over numbered weeks or months: tasks grouped in sections, how long each lasts, what each waits for, how much is done, and the milestones on the way.

Write a task that waits for another as after T1 rather than with a unit of its own; it then moves when the task before it does.

Working example

Copy this complete example into the Source tab, then press Generate. Change its labels or values to make your first version.

Tingraph source
gantt "Thesis Schedule" {
  unit "Week"
  today 5

  section "Proposal"
  task T1 "Literature review" 1 3 done 100
  task T2 "Write the proposal" after T1 2 done 60
  milestone M1 "Proposal defence" after T2

  section "Research"
  task T3 "Build the prototype" after M1 4
  task T4 "Collect the data" after T3 3
  task T5 "Analyse the results" after T4 2

  section "Writing"
  task T6 "Write chapters 4 and 5" after T5 3
  milestone M2 "Final defence" after T6
}

Syntax reference

The same reference used by the editor and AI briefing. Syntax is notation-specific; use the keywords listed here.

Chart

SyntaxMeaning
gantt "Title" {open a Gantt chart
unit "Week"what one numbered unit is called
today 5a dashed line through the unit the chart is read in

Tasks

SyntaxMeaning
section "Research"a section; the tasks after it are listed under it
task T1 "Survey" 1 3starts in unit 1, lasts 3 units
task T2 "Write" after T1 2starts once T1 ends, lasts 2
task T3 "Test" after T1 T2 2starts once both have ended
task T1 "Survey" 1 3 done 6060% of it done
milestone M1 "Defence" after T2a diamond where T2 ends
milestone M2 "Launch" 12a diamond at the start of unit 12

Look

SyntaxMeaning
color "#2a78d6"the colour every bar takes
text 12caption size, 9 to 20
size 760 400width and height on the sheet

Language rules

  • The file is one gantt "Title" { ... } block. Nothing may sit outside it.
  • Time is counted in whole units from 1 (week 1, week 2, …); unit only says what a unit is called.
  • A task is task ID "Name", then either the unit it starts in or after the IDs it waits for, then how many units it lasts. It may end with done and a percentage.
  • A milestone is milestone ID "Name" then a unit or after IDs; it lasts nothing and takes no done.
  • section "Name" lists every task after it under that section, until the next section.
  • Every ID after after is a task or milestone in the chart, and following them never loops back.
  • Settings are written as name value, in any order.
  • Do not invent settings. Every one the language has is listed above.

Edit on the canvas

  • Drag a bar to move it and its right end to change how long it lasts; both snap to whole units.
  • Rename a task or section in place, and add or remove tasks from the sheet or the Gantt panel.

Generate replaces the drawing from source. Save before generating again if you want to preserve manual finishing touches.

Read Saving & exporting

Write it with an assistant

Tingraph AI already knows this notation. For another assistant, copy the tutorial below, describe your diagram under MY DIAGRAM, then paste the returned source into the editor. This prompt includes every syntax row, rule and working example above.

Read the complete prompt
You are writing Tingraph source. Tingraph is a small text language that draws a Gantt chart. Answer with Tingraph source only.

SYNTAX
Chart
  gantt "Title" {             open a Gantt chart
  unit "Week"                 what one numbered unit is called
  today 5                     a dashed line through the unit the chart is read in

Tasks
  section "Research"          a section; the tasks after it are listed under it
  task T1 "Survey" 1 3        starts in unit 1, lasts 3 units
  task T2 "Write" after T1 2  starts once T1 ends, lasts 2
  task T3 "Test" after T1 T2 2  starts once both have ended
  task T1 "Survey" 1 3 done 60  60% of it done
  milestone M1 "Defence" after T2  a diamond where T2 ends
  milestone M2 "Launch" 12    a diamond at the start of unit 12

Look
  color "#2a78d6"             the colour every bar takes
  text 12                     caption size, 9 to 20
  size 760 400                width and height on the sheet

RULES
- The file is one `gantt "Title" { ... }` block. Nothing may sit outside it.
- Time is counted in whole units from 1 (week 1, week 2, …); `unit` only says what a unit is called.
- A task is `task ID "Name"`, then either the unit it starts in or `after` the IDs it waits for, then how many units it lasts. It may end with `done` and a percentage.
- A milestone is `milestone ID "Name"` then a unit or `after` IDs; it lasts nothing and takes no `done`.
- `section "Name"` lists every task after it under that section, until the next section.
- Every ID after `after` is a task or milestone in the chart, and following them never loops back.
- Settings are written as `name value`, in any order.
- Do not invent settings. Every one the language has is listed above.

WORKED EXAMPLE
gantt "Thesis Schedule" {
  unit "Week"
  today 5

  section "Proposal"
  task T1 "Literature review" 1 3 done 100
  task T2 "Write the proposal" after T1 2 done 60
  milestone M1 "Proposal defence" after T2

  section "Research"
  task T3 "Build the prototype" after M1 4
  task T4 "Collect the data" after T3 3
  task T5 "Analyse the results" after T4 2

  section "Writing"
  task T6 "Write chapters 4 and 5" after T5 3
  milestone M2 "Final defence" after T6
}

OUTPUT
- Reply with one fenced code block and nothing else.
- The block starts with `gantt "…" {` and ends with `}`.
- Do not invent keywords: use only the ones listed above.
- Keep labels short enough to read inside a box, and keep every ID unique.

MY DIAGRAM
Describe what you want here, then send this message.
How AI requests, attachments and privacy work

Something unclear? Contact support or read the Privacy Policy.