Gantt Chart fields and settings

Every field well and every setting in the format pane of version 1.0.2.0, read from the package you download. The internal names in grey are what a PBIR file or a report-authoring agent uses. Which features need a licence is on the Gantt Chart page; every setting works in edit mode with or without one.

11 fields · 8 cards · 49 settings Markdown for AI assistants catalog.json

Fields

Field	Takes	Needed	What it is for
Task`task`	Column	Required	Task or activity name
Category / Group`category`	Column	Optional	Optional grouping category for color coding
Parent Task`parent`	Column	Optional	Optional parent task name — builds a collapsible work-breakdown hierarchy with rollup summary bars
Grid Columns`extraColumns`	Column	Optional · up to 3	Optional extra columns (up to 3) shown as a sortable data grid next to task names — e.g. Owner, Status, Cost. Premium feature.
Start Date`startDate`	Measure	Required	Task start date
End Date`endDate`	Measure	Required	Task end date
Progress %`progress`	Measure	Optional	Task completion percentage (0–100)
Dependencies`dependencies`	Column	Optional	Predecessor task name(s), comma-separated — powers dependency arrows and critical-path analysis. Premium feature.
Baseline Start`baselineStart`	Measure	Optional	Planned start date — renders a baseline ghost bar for plan-vs-actual comparison. Premium feature.
Baseline End`baselineEnd`	Measure	Optional	Planned end date — renders a baseline ghost bar for plan-vs-actual comparison. Premium feature.
Tooltips`tooltips`	Measure	Optional	Extra fields shown in the task tooltip

Theme`theme`

Setting	Type and options
Theme`selectedTheme`	Clean (White) `clean` SmartVisuals (turquoise) `smartvisuals` Dark `dark` Slate (corporate) `slate`
Use Report Theme Colors`useReportTheme`	On / off
Transparent Background`transparentBg`	On / off
Background Color`bgColor`	Colour

Chart`chartSettings`

Setting	Type and options
Bar Height`barHeight`	Number
Row Padding`rowPadding`	Number
Label Column Width`taskLabelWidth`	Number
Header Title`cornerTitle`	Text
Bar Color`barColor`Used when no Category field is provided	Colour
Show Today Line`showTodayLine`	On / off
Today Line Color`todayLineColor`	Colour
Highlight Overdue Tasks`highlightOverdue`	On / off
Overdue Color`overdueColor`	Colour
Time Zoom`timeZoom`	Fit to Width `fit` Day (scroll) `day` Week (scroll) `week` Month (scroll) `month`
Bar Style`barStyle`	Auto (by theme) `auto` Rounded `rounded` Square `square` Pill `pill`
Progress Style`progressStyle`	Fill `fill` Slim Bar `slim` None `none`
Progress Format`progressFormat`	Auto-detect `auto` Fraction (0-1) `fraction` Percent (0-100) `percent`
Milestone Shape`milestoneShape`	Auto (by theme) `auto` Diamond `diamond` Circle `circle` Star `star` Flag `flag` Water Drop `drop`
Milestone Color`milestoneColor`	Colour

Legend`legendSettings`

Setting	Type and options
Show`show`	On / off
Font Size`fontSize`	Number
Font Color`fontColor`	Colour
Bold`bold`	On / off

Time Axis`timeAxis`

Setting	Type and options
Font Size`fontSize`	Number
Font Color`fontColor`	Colour
Header Background`background`	Colour
Top Band`topBandFormat`	Auto (Month + Year / Year) `auto` Month only `month` Month + Year `month-year` Hidden `none`
Date Labels`tickFormat`	Auto `auto` Day number (5) `day-number` Day + Month (5 Mar) `day-month`
Bold Dates`bold`	On / off

Labels`labelSettings`

Setting	Type and options
Font Size`fontSize`	Number
Font Color`fontColor`	Colour
Show Task Labels on Bars`showTaskLabels`	On / off
Bold Task Names`bold`	On / off

Categories`categorySettings`

Setting	Type and options
Category 1 Color`color1`	Colour
Category 2 Color`color2`	Colour
Category 3 Color`color3`	Colour
Category 4 Color`color4`	Colour
Category 5 Color`color5`	Colour
Category 6 Color`color6`	Colour
Category 7 Color`color7`	Colour
Category 8 Color`color8`	Colour

Grid`gridSettings`

Setting	Type and options
Show Vertical Grid`showGrid`	On / off
Grid Color`gridColor`	Colour
Shade Weekends`shadeWeekends`	On / off
Summary Row Totals`sumNumericColumns`Sum numeric grid columns on group and parent rows instead of showing their own data value	On / off

Dependencies & Critical Path`dependencySettings`

Setting	Type and options
Show Dependency Arrows`showDependencies`	On / off
Highlight Critical Path`showCriticalPath`	On / off
Critical Color`criticalColor`	Colour
Arrow Color`depLineColor`	Colour

Setting a value in PBIR

In a visual.json, a setting goes under visual.objects, by card and internal name. Toggles take true or false, choices and text a value in single quotes ('auto'), numbers a D suffix (12D).

"visual": {
  "visualType": "ganttChart4E14FBC6E508455AA6A89A17DD336BB8",
  "objects": {
    "theme": [{
      "properties": {
        "useReportTheme": { "expr": { "Literal": { "Value": "true" } } }
      }
    }]
  }
}

Gantt Chart fields and settings

Fields

Themetheme

ChartchartSettings

LegendlegendSettings

Time AxistimeAxis

LabelslabelSettings

CategoriescategorySettings

GridgridSettings

Dependencies & Critical PathdependencySettings