Showing the Loading or Progress Indicator in Creatio (formerly bpm’online)

When you have code that is doing something like calling a configuration service, starting a process, or some other longer running task, it’s always a good idea to show something to the user so they know something is happening. Bpm’online has a built in loading/progress/spinner that you can use for this purpose. Plus, it’s easy to use.

To use this, we’ll need to add MaskHelper to our AMD modules list of our code. What this means is, in the page code you’re calling this from, you’ll add something like this:

define("LeadPageV2", ["MaskHelper"], function(MaskHelper) {
    return {
        entitySchemaName: "Lead",

        // ... all the rest of the stuff


Note the part at the top, you’ll see “MaskHelper” (in quotes) in the square brackets and MaskHelper (not in quotes) in the function parameters. Looking at require.js or other searches for AMD modules will show you more info on this topic, but basically it is a way for a module to be provided to your code for you to use.

Now that you’ve added that, it’s easy to use.

// show loading spinner

// hide loading spinner

Or, if you’d like to set some custom text value for the spinner, instead of the generic “Loading”, you can do that as well:

// show the loading spinner
var maskId = MaskHelper.ShowBodyMask();

// now update the caption
MaskHelper.UpdateBodyMaskCaption(maskId, "Hold on, I'm working on it...");

// hide it normally 

There are a few other ways to show & hide the progress mask in bpm’online, however, I find this approach the most straightforward.

Want content like this delivered to your inbox? Sign up for our newsletter!

Ryan Farley

Ryan Farley is the Director of Development for Customer FX and creator of He's been blogging regularly about SalesLogix, now Infor CRM, since 2001 and believes in sharing with the community. His new passion for CRM is Creatio, formerly bpm'online. He loves C#, Javascript, web development, open source, and Linux. He also loves his hobby as an amateur filmmaker.


  1. Hello Ryan,

    Your article “Showing the Loading or Progress Indicator in Creatio” matches my needs exactly, I implemented the principle as shown, but nothing happens on the screen.

    I see the article is a bit old, should the progress indicator system described still work today?
    I am in Creatio 8.0.5 and my window is not Freedom UI.

    Thank you in advance for your response

    • Yes this still works for classic pages in 8.0.5. If it’s not working for you, there could be something else going wrong. Perhaps start with looking in the dev tools console of your browser for any errors?

  2. its working for freedom ui?


Submit a Comment

Your email address will not be published. Required fields are marked *