Gantt Labels

Key Concepts

The Labels determine what and how much information is displayed on activity blocks of the Gantt at any time. The Gantt color labels are useful for displaying potential problems in the schedule and the timing and status of the scheduled activities. The Activity Display Options dialog can be accessed by clicking on the purple Labels button of the Gantt toolbar:

Scheduled Operations

  • Tooltip Text: This button will open the Tooltip Text Dialog, which is used to specify the text to be displayed in the tooltip generated by hovering the cursor over an activity block.

Note: Tooltips must be enabled for the Tooltip text to be displayed. This can be done by clicking on the (Show Tool Tips) button of the Gantt toolbar

  • Label: This button will open the Block Label Dialog, which is used to specify the text displayed on the Gantt chart's activity blocks. More information on how to customize the text displayed on the activity blocks can be found here
  • Labels to use in the Gantt
    • The single Block Label: When this is selected, the text appearing on the activity block will correspond to the text that is defined under the Label window of the Block Label Dialog.
    • Individual Segment Labels, each drawn on its own Segment: When this is selected, the text appearing on the activity block will correspond to the text defined under the Label window of each segment type's dialog box. To define the text to appear in each segment type, click on the Segment Type box of the corresponding segment.


The options under the scheduled operations tab determine the color of the activity block as seen on the Gantt chart. Activity blocks can show multiple segments and are represented by differently colored horizontal bars. Clicking on the Segment Type box will toggle the option to "Show" and include a horizontal bar on the activity block for that segment type. The color of the segment type depends on the properties of the operation. For example, the following segment types can be displayed on an activity block: 

  • Timing: This segment shows the timing of the job as a comparison of its scheduled start and finishes dates against its due date.

      • Too Early: This is an activity that is started far earlier than is needed. This can pose a risk in which the product created may never sell, making the run a waste. This is especially problematic in food and beverage manufacturing, where shelf-life violations will cause jobs to be re-worked and wasted.
      • On-Time: This is an activity that is scheduled to finish on time.
      • Almost Late: This represents an activity that is currently still set to finish on time but is coming closer to its due date. A setting within the job header controls the almost late setting.
      • Late: This represents an activity that is currently scheduled to finish late because it is waiting on a previous operation that is late.
      • Capacity Bottleneck: This is an activity that is late and causing its downstream operations to be late as well.
      • Material Bottleneck: This is an activity where the required materials are not available early enough for the activity to finish on time and is causing downstream activities to be late as well. 
      • Release Bottleneck: This is an activity that is bottlenecked by a set release date.
    • Commitment: This segment shows the commitment level of the activity.

      • Estimate: This is often an automatically generated job used to forecast demand or work without a firm job or demand behind it.
      • Planned: Similar to estimate, there is more certainty to a planned job, but it is still an order that may not have a firm job behind it.
      • Firm: This is a job that has been created by customer demand via a sales order for a work order.
      • Released: This is a job that has been created by customer demand and has been released to the shop floor for production. 
    • Attribute(s): Attributes are user-defined characteristics of the operations of a job.

      • Show Job Color: This shows a solar segment based on the color code of the job level.
      • Show Product Color: If the product has been given a color code, the label will display this color segment if checked.
      • Show Setup Color: If the setup has been given a color code, it will be displayed if this option is checked.
      • Show Custom Attribute Color: If checked, it will display the color codes of any user-defined attributes on the operation attributes mappings.

    Note: The "Display in Gantt" attribute value will determine whether the particular attribute is shown in the Gantt.

    To display an attribute field value in a Gantt label, use the following format in the label definition:

    • ResourceOperation.ATTRIBUTE.MyAttributeName.Code
      • (Replace MyAttributeName with the actual name of the attribute to display. Replace Code with Number of any other attribute field name to display).
    • If showing attribute segments in the Gantt, then you can use "NAME" as shown below so that the attribute name of the corresponding attribute segment will dynamically be replaced to show each attribute's info:
      • ResourceOperation.ATTRIBUTE.NAME.Code
    • Process: The process segment displays the differentiation between setup, run, post-processing, storage, and storage post-processing times as vertical bars within the segment. 

      • Setup: Displays a label or color for the setup portion of the activity.
      • Run: Displays a label for the portion of the activity that is spent running it.
      • Post-Process: Displays a label for the post-processing portion of the activity
      • Storage: Displays a label for the storage portion of the activity if it is being stored within a tank.
      • Storage Post-Process: Displays a specific label for the post-processing after the storage portion of an activity if it is being stored in a tank.
      • Status: This is the status of an activity.

        • On-Hold: Activities that have been put on hold for any reason will be colored in yellow.
        • Waiting: Activities waiting for a material, a predecessor operation, or a predecessor manufacturing order will be colored in blue.
        • Setting-Up: Activities that are currently being set up to begin production will be colored in red. 
        • Post-Processing: Activities that are finished in production but undergoing follow-up processing such as drying or curing will be colored light green.
        • Transfering: Activities finished in production and transferred to the next resource or inventory will be colored in grey.
        • Running: Activities currently in production will be colored in dark green.
        • Ready: Activities that have all of their constraints (material, predecessors, MO release date) satisfied and are ready to start at any time will be colored in white. 
        • Started: Activities that have had time or quantity reported or worked on will be colored in light green.
        • Paused: Activities that have been paused will be colored in dark yellow.
      • Material Status:

        • Material Sources Unknown: Materials required for this activity are not currently planned.
        • Material Sources Planned: Materials required for this activity are planned.
        • Material Sources Firm: Materials required for this activity are confirmed. 
        • Material Available: The materials required for the activity are available.
      • Item Types included in material labels.
      • Priority: This segment displays the priority number assigned to the job. 

      Note: Lower numbers are given higher priority in PlanetTogether and are marked with "hotter" colors. 

      • Buffer: This segment displays the level of buffer penetration for either material, drum, shipping, or stock buffers.

        • OK: Less than 33% buffer penetration.
        • Warning: Between 34% and 66% buffer penetration.
        • Critical: More than 66% buffer penetration.
        • Late: This activity is late. 
      • DBR Penetration Type: There are two types of buffer penetration types for manufacturing orders
        • Current: This is based on the current PC time and the manufacturing order's current status.
        • Projected: This is based on where the manufacturing order is currently scheduled on the Gantt. 
      • % Finished: This segment displays as a percentage the comparison of the quantity of the reported goods against its required finish quantity.

      Adding User Defined Fields to Gantt Labels

      User-Defined Fields can be added to the Labels by entering them in the following format:
      <object type>.UDF.<FieldName>
      For example: Job.UDF.Width

      Actuals: These color codes and labels pertain to activities that are finished or partially finished.

      Note: Actuals are drawn with a "brick" pattern and dotted border to help differentiate them from scheduled activities. 


      Flags: These options provide visual flags as hexagonal block segments to alert for specific conditions that may need the planner's attention.

      • Show Standard Flags: Checking this box will allow users to click on the options found below it. Users can choose to show flags for jobs, manufacturing orders, operations, activities, blocks, and material requirements.
      • Show Custom Flags: Custom flags can be created and used. However, these require defining a Customization DLL to create. 
      • Brick Fill Pattern: Activities with a "brick" fill pattern cannot be moved due to Lock and Anchor, Move Disallow, or In-Process Status. 
      • Border Meanings: The activity blocks can have borders to help visualize the status of the activity.
        • Constrained: An activity that is constrained will show a thick black border on the left side of the activity bock.
        • Locked: Activities locked to a resource will show a dark blue border at the top of the activity block.
        • Anchored: Activities anchored in time will show a dark blue border at the bottom of the activity block.
        • Hot: Activities and Jobs set to "Hot" (to designate a job as important) will show a red border around the activity block. 
        • Anchor Drift: Activities that Anchor Drift impacts will show either a yellow or an orange border around the activity block - yellow if the amount drifted is less than 1 day, and orange if the amount drifted is more than 1 day.
      • Highlight Un-reviewed Jobs: All un-reviewed jobs will be highlighted in bright pink if this box is checked. New jobs that come into the schedule are considered un-reviewed. These will remain bright pink until the scheduler clicks on them, alerting the system that it is okay if these jobs are scheduled. 


      Label Formatting: This pane allows users to change the text formatting of the block labels. 

      • Text direction: This can be set to show only vertical text or be set to horizontal or vertical depending on the block proportions.
      • Wrap Lines: When checked, the text lines will wrap at the end of the activity block to make all of the text visible in the block.
      • Padding: This feature allows text to be padded away from the top and left borders to improve readability. Higher numbers will add more space. 
      • Font: When this button is clicked, a new Font dialog opens where users can select the type of font, font style, and size they wish to use in the block labels. 

      Custom Gantt Activity Colors:

      1. Use the Attribute or Job color codes. Currently, they can only be set during import or manually.
      2. Use the current Flags functionality in an Add-in to create custom color flags via the Flag.ColorCode setting.


      Watch: Gantt Labels


      Watch: Displaying & Viewing Note Fields on Gantt Labels

      Related Articles


      Gantt Toolbar