Get SharePoint Lists with Unique Permissions using PnP JavaScript Library

This blog share the details on getting the SharePoint Lists with Unique Permissions from the Site using PnP JavaScript Library

PnP-JS-Core library contains the number of extensible methods and properties. By using that we can achieve the various actions in a simple code. To know more about this library component, visit the below links,

Simplified JavaScript Library for SharePoint

PnP-JS-Core Library

This post explains,

How to use PnP JavaScript Library to get the SharePoint Lists, which are having Unique Permissions from SharePoint site.


$pnp.sp.web.lists.filter('HasUniqueRoleAssignments eq true').get().then(function(result){})


The below steps and code snippet used to get the SharePoint Lists with unique permissions from the SharePoint site.

  1. Download Required files to use PnP-JS-Core library from the below links and upload that to Site Asstes or Style Library
    • Download pnp.js  PnP JS file
    • Download fetch.js Used by PnP js file to handle web requests and responses (Required in IE)
    • Download es6-promise.js Used by PnP js file to handle web requests and responses (Required in IE)
  2. Create new web part page and insert Content Editor web part
  3. Create a sample.html file in Site Assets or Style library and insert the below code snippet.

    [code language=”javascript”]

    <script type="text/javascript" src="/siteassets/scripts/fetch.js"></script>
    <script type="text/javascript" src="/siteassets/scripts/es6-promise.js"></script&gt;
    <script type="text/javascript" src="/siteassets/scripts/pnp.min.js"></script>

    <div id="sample"></div>

    <script type="text/javascript">
    //lists property returns all lists from the SharePoint site
    //Use the filter method to get only Lists with Unique Permissions by using the property "HasUniqueRoleAssignments"
    //then( ) runs on success
    //catch( ) runs on failure
    $pnp.sp.web.lists.filter(‘HasUniqueRoleAssignments eq true’).select(‘Title,BaseTemplate’).get().then(function(result) {
    var listsInfo = "";
    for (var i = 0; i &lt; result.length; i++) {
    listsInfo += "Title: " + result[i].Title + "<br/>";
    document.getElementById("sample").innerHTML = listsInfo;
    }).catch(function(err) {


  4. Add the URL of sample.html file to the content editor web part
  5. Click OK to apply the changes to the web part and save the page.
  6. Now the page displays a Lists with Unique permissions from the SharePoint website using PnP JavaScript method .

Note: Supports SharePoint 2013, SharePoint 2016 and SharePoint Online. For on-premise environment, PnP requests will not work properly due to JSON Light is not enabled by default. To enable , we have to modify the headers before calling PnP methods. Check this link for setup the headers.

[code language=”javascript”]

//Set response type in headers
headers: {
"Accept": "application/json; odata=verbose"



Lists with Unique Permissions
Fig 1: Lists with Unique Permissions
Shantha Kumar
Shantha Kumar
Articles: 270


Leave a Reply

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