OverviewLink to Overview

Rendered Chart

Parameters in Macro Browser

TypeGantt
Labels column
  • Phase (project) *
  • Step
  • Milestone (a star that is a key event of a particular phase)
  • Event (a vertical line that doesn't belong to any phase)
  • Today
  • Description of Milestone
  • Description of Event
Values column
  • Start Date *
  • End Date *
  • Completion Ratio (the percentage of completed work)
  • Date

*  - Minimum required columns to build the Gantt chart

See also a blog post: 5 Tips to Become a Gantt Chart Expert Using Atlassian Confluence to learn more about the completion ratio, events, and milestones on the Gantt chart.

Data Tables in Macro Placeholder

Phase

Step

Start Date

End Date

Completion Ratio

Phase One

Planning and Research

01 Jan 2025

30 Jan 2025

100%

Phase One

Development

01 Feb 2025

30 Apr 2025

86%

Phase One

Testing

15 Apr 2025

15 May 2025

20%

Phase One

Deployment

12 May 2025

15 Aug 2025

50%

Phase Two

Planning and Research

15 Jun 2025

15 Jul 2025

0%

Phase Two

Development

10 Jul 2025

15 Oct 2025

0%

Phase Two

Testing

3 Oct 2025

21 Nov 2025

0%

Phase Two

Deployment

18 Nov 2025

15 Dec 2025

0%

Phase

Milestone

Text

Date

Phase One

RC

something

7 May 2025 

Phase Two

RC

something

30 Oct 2025

Event

Date

Demo 1

12 May 2025

Demo 2

10 Oct 2025

Today

Date

Today

today

Here's the example on how to calculate the completion ratio in Table Transformer.


Settings TabLink to Settings Tab

Select the chart typeLink to Select the chart type

To select the chart type in the page view mode:

  1. Insert the Chart from Table macro.
  2. Hover over the chart controls on the right of the table.
  3. Locate the Type option and select the chart type. The chart will be automatically regenerated.
  4. To save the modifications in the macro body, click the cogwheel icon and select Save changes.

To select the chart type in the macro browser:

  1. Switch the page to the edit mode.
  2. Insert the Chart from Table macro and paste the table within the macro body.
  3. Select the macro and click Edit.
  4. Locate the Type option in the Settings tab and select the chart type.
  5. Save the macro and the page.

Select data seriesLink to Select data series

Labels column - the column containing labels for data values.

Values column - the column or columns containing numerical values for chart generation.

To select data series in the page view mode:

  1. Insert the Chart from Table macro.
  2. Hover over the chart controls on the right of the table.
  3. Locate the Labels column and Values column options and select the table columns containing data for chart generation. The chart will be automatically regenerated.
  4. To save the modifications in the macro body, click the cogwheel icon and select Save changes.

To select data series in the macro browser:

  1. Switch the page to the edit mode.
  2. Insert the Chart from Table macro and paste the table within the macro body.
  3. Select the macro and click Edit.
  4. Locate the Labels column and Values column options in the Settings tab and select the table columns containing data for chart generation.
  5. Save the macro and the page.

Adjustments TabLink to Adjustments Tab

Set the decimal separatorLink to Set the decimal separator

  1. Switch the page to the edit mode.
  2. Select the macro and click Edit.
  3. Switch to the Adjustments tab.
  4. Locate the Decimal separator option.
  5. Specify the correct decimal separator for numeric values in the source table (point or comma).
  6. Save the macro and the page.

Set the table data orientationLink to Set the table data orientation

  1. Switch the page to the edit mode.
  2. Select the macro and click Edit.
  3. Switch to the Adjustments tab.
  4. Locate the Table data orientation option.
  5. Select the Vertical or Horizontal option.
  6. Save the macro and the page.

Set the minimal and maximal valuesLink to Set the minimal and maximal values

Minimal value - the minimal value for showing only data values greater than the specified minimal value.

Maximal value - you can specify the maximal value for showing only data values not greater than the specified maximal value.

  1. Switch the page to the edit mode.
  2. Select the macro and click Edit.
  3. Switch to the Adjustments tab.
  4. Locate the Minimal and Maximal value options and set the values.
  5. Save the macro and the page.

Set the scale stepLink to Set the scale step

Scale Step - the required scale step for showing the numeric values in the chart.

  1. Switch the page to the edit mode.
  2. Select the macro and click Edit.
  3. Switch to the Adjustments tab.
  4. Locate the appropriate option depending on the chart type and set the scale step.
  5. Save the macro and the page.

Date & Worklog TabLink to Date & Worklog Tab

Set the date formatLink to Set the date format

  1. Switch the page to the edit mode.
  2. Select the macro and click Edit.
  3. Switch to the Date & Worklog tab.
  4. Locate the Date format option.
  5. Specify the correct date format for date values in the source table.
  6. Save the macro and the page.
If the app detects the incorrect date format in the page view mode it presents you with the note panel where you can enter the correct date format. It is saved automatically if it is treated as the correct date format.

Set the worklog settingsLink to Set the worklog settings

Please ensure that the worklog parameters set in the macro are identical to parameters configured in Atlassian JIRA.
  1. Switch the page to the edit mode.
  2. Select the macro and click Edit .
  3. Switch to the Date & Worklog tab.
  4. Locate the Worklog settings option.
  5. Define the worklog parameters, as follows:
    1. Days in year - enter the number of days in a year.
    2. Days in week - enter the number of business days in a week.
    3. Hours in day - enter the number of working hours in one business day.
    4. Time format - select the used time format in worklog values.
    5. Year shortening - enter the shortening for the year time unit if you use any language different from English.
    6. Week shortening - enter the shortening for the week time unit if you use any language different from English.
    7. Day shortening - enter the shortening for the day time unit if you use any language different from English.
    8. Hour shortening - enter the shortening for the hour time unit if you use any language different from English.
    9. Minute shortening - enter the shortening for the minute time unit if you use any language different from English.
  6. Save the macro and the page.
Worklog time units in different languages are denoted with different shortenings. Please adjust them according to your JIRA localization settings.

Appearance TabLink to Appearance Tab

Set the height and width of the chartLink to Set the height and width of the chart

  1. Switch the page to the edit mode.
  2. Select the macro and click Edit.
  3. Switch to the Appearance tab.
  4. Locate the Height and Width fields.
  5. Enter the appropriate dimensions of the chart.
  6. Save the macro and the page.

To set the Height and Width of the chart in the page view mode:

  1. Hover over the chart controls on the right of the table.
  2. Locate the Height and Width fields.
  3. Enter the appropriate dimensions of the chart.
  4. To save the modifications in the macro body, click the cogwheel icon and select Save changes.

 Add /bar after the height value to set the height of bars.

Align chartLink to Align chart

  1. Switch the page to the edit mode.
  2. Select the macro and click Edit.
  3. Switch to the Appearance tab.
  4. Locate the Align chart option.
  5. Select the appropriate chart alignment, as follows:
    • Left
    • Center
    • Right
  6. Save the macro and the page.

Set the chart titleLink to Set the chart title

  1. Switch the page to the edit mode.
  2. Select the macro and click Edit.
  3. Switch to the Appearance tab.
  4. Locate the Chart title option and enter the title.
  5. Save the macro and the page.

Set axis labelsLink to Set axis labels

  1. Switch the page to the edit mode.
  2. Select the macro and click Edit.
  3. Switch to the Appearance tab.
  4. Locate the Row axis label and Date axis label options and enter the labels.
  5. Save the macro and the page.

Show/Hide source dataLink to Show/Hide source data

  1. Switch the page to the edit mode.
  2. Select the macro and click Edit.
  3. Switch to the Appearance tab.
  4. Locate the Source data option and select the appropriate option, as follows:
    • Show all content
    • Hide tables
    • Hide all content
  5. Save the macro and the page.

To show/hide source data in the page view mode:

  1. Hover over the chart controls on the right of the table.
  2. Click the cogwheel icon, select the Show source content, Hide source content (Hide tables, Hide all content) option.
  3. To save the modifications in the macro body, click the cogwheel icon and select Save changes.

Show gridLink to Show grid

  1. Switch the page to the edit mode.
  2. Select the macro and click Edit.
  3. Switch to the Appearance tab.
  4. Locate and enable the Show grid option.
  5. Save the macro and the page.

Hide chart controlsLink to Hide chart controls

  1. Switch the page to the edit mode.
  2. Select the macro and click Edit.
  3. Switch to the Appearance tab.
  4. Locate and enable the Hide chart controls option.
  5. Save the macro and the page.

Colors TabLink to Colors Tab

Set colorsLink to Set colors

  1. Switch the page to the edit mode.
  2. Select the macro and click Edit.
  3. Switch to the Colors tab.
  4. Locate the Color scheme field and choose the required option: Single color, or  option.
  5. Save the macro and the page.

To set the colors in the page view mode:

  1. Hover over the chart controls on the right of the table.
  2. Click the cogwheel icon, locate the Select colors option. Select the  or  option. Pick the colors or columns with colors and click Save. The chart will be automatically regenerated.

  3. To save the modifications in the macro body, click the cogwheel icon and select Save changes.




Preview OptionLink to Preview Option

While working in the edit mode, use the Show/hide preview option to adjust the required settings before saving the macro and publishing the page.


Filter the Source TableLink to Filter the Source Table

  1. Select one or more chart columns/sectors/bars.
  2. Only the related rows of the source table are displayed.
  3. Deselect all the columns/sectors/bars to display the whole source table.

Set DependenciesLink to Set Dependencies

  1. Open the page with the chart.
  2. Click the cogwheel icon and select the Set dependencies option.
  3. Locate the arrows between tasks.
  4. To save the modifications, click the cogwheel icon and select Save changes.

Zoom in ChartLink to Zoom in Chart

To zoom in the chart:

  1. Open the page with the chart you want to zoom in.
  2. Hover your mouse pointer over this chart.
  3. Hold down Ctrl and rotate the wheel button forward to zoom in the chart.

To navigate across the chart:

  1. Hold down Ctrl (for Windows) or Alt (for MacOS) and drag the mouse pointer across the chart.