It’s the balloons time (when the help panes are feeling empty)

By | November 16, 2019


I just learned how to create balloons!


At first, it actually did not look that interesting at all when I clicked the question mark button:




Yep, it felt a little empty there. So, I started to wonder, what can I do to make it more interesting?

Turned out there is quite a bit we can do:

We can add sections, images, bullet lists, videos, some other things… and, of course, those balloons.

The thing about the balloons, though, is that they are linked to the page elements, so, if the elements change (or if you navigate to a different page), the balloons might stop flying. Well, that’s just a note – other than that the balloons still are awesome.

So, what is it we may want to keep in mind about the help panes?

We can add them to the solutions. Although, only while in the classic(?) mode



We can work with the help XML using the definition below. Although, I guess that involves extracting solution files, updating them, then packing them back into a solution file (would be a good use for the solution packager)

The help pane will stay open as the user keeps navigating in the app

This may bring the help pane a little bit out of content, so the users would have to remember to either close it or to click “home” button at the top left corner to change context for the help pane.

Help panes are language-specific

I just switched to French, and the help pane is feeling empty again


I used Dynamics 365 environment everywhere above, but it’s actually working in the CDS environments, too



Well, it seems to be a pretty cool feature. Of course help authoring may take time, and keeping it up to date may take time, too. But it seems to be a nice easy-to-use feature which can help even if we choose to only use it sporadically where it’s really needed.

3 thoughts on “It’s the balloons time (when the help panes are feeling empty)

  1. Lars

    Hi Alex,

    in my european environments I’m currently not able to edit the help panes. The Edit button stay disabled in any case even though I enabled help panes as explained in the docs.
    How did you achieve editing the help panes?

    1. Alex Shlega Post author

      Hi Lars, did you try a custom model-driven app? I am not sure why, but, it seems, it’s not working for the first-party apps

  2. John Stevens

    Any else having trouble with the “Edit” button being disabled?

    Alex, any thoughts on this?


Leave a Reply

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