The List Gantt View web part takes a list in the web it is located in and renders it in a BrightWork Gantt style view. You can opt to show all items in the list, use the filtering defined in specific list view, or write your own CAML filter.

If the filtering options in the selected view are updated, this will be reflected in the List Gantt View web part. The web part can be added as normal.

This topic relates to configuring the List Gantt View web part, for information on configuring a BrightWork Reporter Gantt report, click here.

All web parts share basic modification functionality - click here to learn about this. Modification options specific to the List Gantt View web part are addressed below.

The Report Information Icon

When you click the report information icon in the title, a popup shows the details of the current report. It also expands the Ribbon, opening the tab associated with the web part.

Details include: the report title, the type of report, the data source the list uses, and what filters are applied.

Configure the List Gantt View

To configure the List Gantt View web part:

  1. Click in the List Gantt View title to expose the ribbon.
  2. Click the Gantt ribbon tab and then click Configure Gantt Settings.

Gantt Data Source

  • Select List:
    Select the list that you want to report off.

  • Filter
    There are three options:

    • All items in this list
      This includes all list items from the selected list.

    • All items in this view
      This uses the filtering from the selected view in the selected list. If there is no filtering specified in the selected view all list items are included.

    • Specify filter (CAML)
      This allows you to write your own CAML filter and insert the code.

Web Part Settings


Enter a title for the report.


Select a chrome type for the report:

  • Default
  • Border Only
  • None
  • Title and Border
  • Title Only

Gantt Data Binding

Gantt Columns

Select the columns to be represented in the Gantt chart.

Start Date

Select the date column to be used as the start date.

End Date

Select the date column to be used as the finish date.

Percent Complete

Optionally, select the column to be used as the Percent Complete column - generally this will only be the % Complete column.

Milestone Flag

Select a boolean column to enable the milestone diamond visual indicator.

Gantt Labels

Select the columns that will supply the Gantt Label (i.e. the data that appears to the right of each bar in the Gantt) for each type of column rendered by the Gantt:

  • Summary Task Label
  • Task Label
  • Milestone Label

Display Hierarchy

Select Display Hierarchical Gantt to display the plan-based list in a hierarchical Gantt view with indenting, bolding, different bars for Tasks and Summary Tasks and Gantt bar connectors.

Selecting Display Hierarchical Gantt means that the Milestone Flag, Sort and Group By settings will be ignored.

Data to exclude:

Select Exclude items when the 'Start Date' is not set to exclude items with no Start Date from the report.

Excluding these items can improve performance and make the report easier to read.

Gantt Appearance

Use these settings to customize the appearance of the Gantt report.

Gantt Theme

Select a display theme for the Gantt

Row Height

Specify a row height between 10 and 40 pixels.

Page View Options

Decide whether or not to use paging and specify the number of rows per page.

Paging splits a report up into pages. The number of pages is defined by the number of items returned and the number of rows set per page. This is useful for increasing performance when a report is returning a lot of items. The actual number of pages is displayed at the bottom of the left column of the report.

Column Settings

Select the columns to be included in the report and the order in which you want them to appear.

For each column, you can also set custom properties:

  • Custom Caption (not available for icon columns)
  • Caption Visibility
  • Column Width

Link Column Settings

Select the columns to be included in the report, the order in which you want them to appear and specify a width (between 20 and 600 pixels) for each column.

Enable or disable the link column; when enabled, the following settings become available:

Link Column

Select the column you want to use to link to the individual list items. When a user clicks on the link the item will open in read mode.

Select how you want the links in reports to behave:

  • Dialog
    Selecting Dialog means links will open items in the pop-up dialog.
    This means you can view and edit individual list items and stay in the context of the page or report you are on. Most importantly, this works across sites and lists, meaning you can edit items in different lists and sites from the one location in a site collection.

    Select Refresh on Update so that when an item is saved from a Dialog the page is automatically refreshed. This will update the whole page, not just the specific web part, and therefore update other web parts that are impacted by the same update.

    The Refresh option is available when the:
    • Dialog option is selected for the 'Open the Link in a' option
  • Same Window/Tab
    Link will open in the same browser tab (or window) as the report.

  • New Window/Tab Once Only
    Link will open in the same separate browser tab (or window).

  • New Window/Tab Each Time
    Link will open in a new browser tab (or window) every time.


Select the column(s) you want to use to sort the items returned (i.e. the order in which the items are displayed in the report) and the direction you want them to be sorted.

If Display Hierarchical Gantt is selected all Sort settings will be ignored.

Group By


  • The column(s) you want the items returned to be grouped by (you can use up to a maximum of 4 groups)

  • The direction of the grouping (ascending or descending)

  • Whether you want the group(s) to be collapsed or expanded

Grouping is placed over the link column.

Selecting Collapsed in any group means that all subsequent groups below that group will also be collapsed.

If Display Hierarchical Gantt is selected all Group By settings will be ignored.

Time Window Settings

Initial View

Select the Time Window that the Gantt should report on.

  • All Data

  • This shows all items returned from the earliest date found to the latest date found.

    Select this setting with caution as it could take a long time to load and slow down the rendering of the report.

  • From Today

    Specify the number of days, weeks or months to use to create the time window.

  • The narrower the time window the quicker the report will render.
    • Looking Back:
      Select the time period the report should look back.

    • Looking Forward:
      Select the time period the report should look forward.

Time Window Width

Specify a width (between 250 to 3000 pixels) for the time window.

The time window is the right-pane of the Gantt where the bars are displayed.

Pan Factor

Specify a value (between 50 and 100%) for the pan factor.

The pan factor defines the amount of the Gantt that will still be displayed when one of the + or - pan buttons are clicked.

Was this article useful?

Back to Top