Free Widget of the Month

To help contribute back to the community, we’re going to try to develop and give away one new widget per month.

For January we have developed the “Related List” widget, which allows you to display related lists on the form page in Service Portal.

Example below from a service catalog request:


Please let us know what you think in the comments below or by tweeting at us at: @newrocketinc


  1. Awesome – thanks! A reporting widget would be awesome for external customers…love the related lists, very useful, thanks!

  2. Hi Nathan, awesome job for our community.

    I would like to request an infinite scroll or pagination widget for catalog or knowledge.


    1. Hi Diego, we already have widgets with pagination and filtering for catalog and knowledge… if you’re interested, send me an email and I can provide you with pricing.

  3. awesome job. Thanks for sharing!

    May I ask if it is (easilly) possible to make it sensitive to the view ?
    If I am not wrong, it always uses the default one, right?


  4. Hi Nathan

    Do you have some kind of simple guide, as I followed the pdf but didn’t get a result.

    Opened the ‘Form’ page, however it says ‘Record not found’.
    for step 5, I can’t find where to add the table and sys_id.



    1. The table and sys_id are passed in through the URL. You would never view the “form” page directly but always through viewing a record

  5. Hi Guys,

    Love your work and I’m checking your site every now and then for the next “Free widget of the month” , when can we expect this?

    1. Thanks Ray, it’s coming soon… we’ve just been super busy. Any recommendations or requests for widgets?

  6. Can I get some help on how to download this? I downloaded but I don’t see the update set that’s referenced in the instructions.

    1. It embeds the data table widget, which is checking ACL’s and permissions. Users will only see in portal what they have permission to see.

  7. This is much further than I have been able to make it on my own. When I put on the page, using the parameters, I get different results than the actual related list in the view. We are trying to use this to show attachments – I see just the attachments on the actual record from the fulfillment side. In the portal, I see attachments, but all the attachments in the system. Playing with it, I think it has to do with the sys_id, but not sure yet.

    1. Brandy,

      Strange… I have not seen this before. We are limited by the $sp.getForm method which provides the related list tables and relationships. It’s possible that there could be a defect in the API. Feel free to email me any details and if I have time I can take a look.

  8. I used the widget on a custom table. Created an approval relationship on the custom table.
    I can see the number of records in the related list. But on the portal I can see the count correctly but no records in the list.

    Can you help please?


  9. This is great! But, how can I prevent duplicates? Using it under a form, I can see the Related Lists on the form widget and then in the related list widget.

  10. Hello, What is the most efficient way of adding New button on the list ? so user can create a new record and save it. Thanks

  11. Hi Nathan,
    Firstly thankyou for all of your Service Portal content. we use quite a few of your widgets 🙂

    For this particular one though, I’ve encountered a similar issue. When using my own relationship with custom “query with” code to join two tables inherited from task (incident and our own customer interaction table). The related list is showing every record in the task table and skipping the “Query with” code.
    Ill see if i can work out a fix myself but if you already have a solution that would be awesome 🙂

    Slighly modified your code to change the default view of view=’sp’ to allow the view being parsed in via the URL as well 🙂 love your code and work ! — cheers Lee

  12. Nathan, are you still supporting this widget? I previously used it to show the Approvals related list for Requested Items. It was nice to show the requestor where it was in the process. However, the widget won’t even load for a non-roled user anymore. Adding the “approver_user” role works, but I don’t want that. I’ve tried ACLs, but I haven’t been able to figure it out.

    Any thoughts?

    1. Hi Shane, a few of these widgets could use an update. Based on how the related list widget works, it’s just displaying the related lists based on the response from the Form API ($sp.getForm())… so chances are it’s ACL related, but I would need to test it to confirm.

      1. Hey Nathan i used $sp.getForm() API in one of my custom widgets to make a better form experience. It works fine for the users who have the right to see the data (ACLs) but when the end user use the same it shows – NO elements to display. I checked and found that data.f is coming empty in the server side code which uses $sp.getForm(). Is there any way of acheiving it ??

        1. It’s based on ACL’s. If the user does not have Read permission on the table, then $sp.getForm is not going to return the data. This is correct and by design.

  13. I would like to only show 1 related list in my portal. It is a custom table. Is there a way for me to use this widget and just have it clickable to show the form the way the OOTB related list widget works?

Leave a Reply

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