Engineered Code is proud to announce the availability of ecLearn - the Learning Management System built on top of Microsoft Dataverse


Power Apps Portals: Notes vs Timeline Metadata – Timeline Metadata Deep Dive

In this series of blog posts, I’m looking at the ways to enable an asynchronous conversation between Dynamics/Power Apps users and portals users. The two most common techniques I see use Entity/Web Form Metadata – either the Notes or Timeline metadata option. This post covers the newer way – using the Timeline metadata option.

Timeline Metadata Overview

Enabling Timeline Metadata causes the Portal to display activities related to the record on the Portal. The Portal also comes with a custom activity type, called Portal Comment, can be created by both Portals users and Dynamics 365/Power Apps users.

Steps to Configure

Unfortunately, Microsoft doesn’t have step-by-step instructions for using the Timeline metadata option.

So here is what I’ve put together:

  1. Ensure that Activities has been enabled for the entity.
  2. Add the Timeline control to your model-driven app form. Note that currently this requires going to the Classic solution editor, as the new “maker” experience does not allow you to add/edit the Timeline control.
  3. Ensure that the “Activities” tab is selected at the Default tab on the Web Client Properties -> Display tab of your Timeline control properties. See the Issues with Default tab Setting section below if you see Activities as the default, but the Timeline still isn’t showing up on the Portal.
  4. On your Entity/Web Form, add a new Metadata record with a type of Timeline:
  5. Set your desired settings for whether users can create Portal Comments, as well as attach files. The Advanced settings allow you to control various aspects of the user interface.
  6. Configure Entity Permissions.
    1. For read-only for any activity type (including Portal Comments), create an Entity Permission for Activity (activitypointer) with Parent scope pointing at the Entity Permission of the primary record.
    2. If you want users to create Portal Comments on the Portal, create an Entity Permission for Portal Comments (adx_portalcomment) with Read, Create, and Append privileges with Parent scope pointing at the Entity Permission of the primary record. Make sure that users have the Append To privilege on the primary entity.
  7. You can configure which activity types are displayed in your Timeline by modifying the filter criteria on the Portal Timeline View that exists for the Activity record type. You can include custom activity types if you want. By default, you’ll see Phone Calls, Appointments and Emails, in addition to Portal Comments. For more info, see
  8. Make sure to clear the Portal cache to see your changes.

A few other comments:

Issues with Default tab Setting

If you’re setting up the Timeline metadata on a custom entity, and you just can’t get it to display on the Portal, try changing the Default tab option to something other than Activities, and then change it back.

The Portal code looks at the configuration in the form XML to see if the setting for the Default tab is Activities. When you add the Timeline control to the form, Activities is the default option, and so you see it in the dropdown. My theory is that since it’s the default option, that the value isn’t saved back to the form XML unless a change is made. So to force it to actually save Activities as the Default tab, switch it to something else, save, and then switch it back.

Guest Contributors

I’d like to acknowledge the individuals who have provided invaluable assistance to this series of posts, including providing their comments, insights, experiences and review:

4 responses to “Power Apps Portals: Notes vs Timeline Metadata – Timeline Metadata Deep Dive”

  1. David Ranwell says:

    Brilliant & thks all

  2. Ken Champion says:

    Thanks for the post. I am having trouble on step 6b where I am trying to create an Entity Permission for Portal Comment. I can select the Parent Entity Permission, but, the selector for “Parent Relationship” never populates. It shows a spinny circle.

  3. Ken Champion says:

    Update. I did your “Issues with the Default Tab Setting” steps, published, cleared the cache, THEN I was able to fully configure my Portal Comment Entity Permission. Strange.

  4. HMZ says:

    Can’t thank you enough for the ‘Issues with the Default Tab Setting’ fix.

Leave a Reply

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


Engineered Code is a web application development firm and Microsoft Partner specializing in web portals backed by Dynamics 365 & Power Platform. Led by a professional engineer, our team of technology experts are based in Regina, Saskatchewan, Canada.