Home - adaptlearning/adapt-contrib-pageLevelProgress GitHub Wiki

Page Level Progress

Page Level Progress is an extension bundled with the Adapt framework.

Progress bar clicked and drawer opening, showing completion status of components

Progress bar on menu item showing percentage of components completed This extension displays the learner's progress through a page via a progress bar displayed in the top navigation bar. Progress is calculated as the percentage of child components that have been completed. Clicking on the progress bar opens the drawer to reveal completion status of individual components. Page progress may also be displayed on menu items representing the page.

Visit the page dedicated to Usage and Tips.


As one of Adapt's core extensions, Page Level Progress is included with the installation of the Adapt framework and the installation of the Adapt authoring tool.

  • If Page Level Progress has been uninstalled from the Adapt framework, it may be reinstalled. With the Adapt CLI installed, run the following from the command line:
    adapt install adapt-contrib-pageLevelProgress

  • If Page Level Progress has been uninstalled from the Adapt authoring tool, it may be reinstalled using the Plug-in Manager.

Back to Top


The settings listed below are the properties that may be configured within the authoring tool. Listed first is the name of the property as it is presented in the authoring tool. It is followed in parentheses by the property as it is used in the Page Level Progress source code. Finally, an explanation is provided to help the course author better utilize the property.

The relationship between Page Level Progress's properties and the way they are presented in the authoring tool’s interface is governed by properties.schema.

Is Enabled (_isEnabled): Turns on and off Page Level Progress. Acceptable values are true and false. This true/false switch is available in course configuration, pages/sections, and components.

Is Optional (_isOptional): This true/false switch is available on individual menus, pages, articles, blocks, and components. If set on an element that has "child" elements (e.g., blocks that contain components), all the "children" will inherit the setting from their parent element. Is Optional is a property that is utilized by several extensions. To Page Level Progress it signifies that the course element does not need to be included when calculating the percent of components that have been completed. Because this property is read by other extensions, the choices made for Page Level Progress will affect Spoor. [Provide an example of how these interact.]


No known limitations.

⚠️ **GitHub.com Fallback** ⚠️