Create New User Role in Alfresco

In my previous article we checked out the permissions system in Alfresco. Sometimes, we may find ourselves in a situation where none of the default privileges match our needs and so, we need to create a new role with those set permissions. In this article I will show you how to create a new role with the desired privileges.

Steps to Create New Role

Step 1:

Create sitePermissionDefinitions.xml under following location in your Alfresco installation.


Step 2:

Copy site related entry from existing sitePermissionDefinitions.xml file from following location


Step 3:

Add one more entry of “permission Group” in new sitePermissionDefinitions.xml file

It should look like this after adding entry

<?xml version='1.0' encoding='UTF-8'?>

<!DOCTYPE permissions >



     <namespace uri="" prefix="sys"/>

     <namespace uri="" prefix="cm"/>

     <namespace uri="" prefix="st"/>


   <permissionSet type="st:site" expose="selected">

     <permissionGroup name="SiteManager" allowFullControl="true" expose="true" />

     <permissionGroup name="SiteCollaborator" allowFullControl="false" expose="true">

         <includePermissionGroup permissionGroup="Collaborator" type="cm:cmobject" />


     <permissionGroup name="SiteNewRole" allowFullControl="false" expose="true">

            <includePermissionGroup permissionGroup="Contributor" type="cm:cmobject" />


     <permissionGroup name="SiteContributor" allowFullControl="false" expose="true">

         <includePermissionGroup permissionGroup="Contributor" type="cm:cmobject" />


     <permissionGroup name="SiteConsumer" allowFullControl="false" expose="true">

         <includePermissionGroup permissionGroup="Consumer" type="cm:cmobject" />




In this case we have added new role called “SiteNewRole”

Step 5:

Add entries related to new role in property files


group.SiteNewRole =New Collaboratorrole.SiteNewRole =New Collaborator Role

Step 6:

Add following entry in


role.SiteNewRole=New Role privileges

NOTE: Ideally we should not change out of box files for customization best practice is to override the given component using extension module

Further Reading:

Looking for quality Alfresco Web Hosting? Look no further than Arvixe Web Hosting!

Tags: , , , , | Posted under Alfresco | RSS 2.0

Author Spotlight


I love opensource technologies working with those technologies from the time I have stepped in to the Software Industry. Alfresco CMS is my area of expertise. I have worked on various complex implementations which involved integration of Alfresco with other technologies, extensively worked with JBPM workflows and Webscripts.

One Comment on Create New User Role in Alfresco

  1. Mythily says:

    Hi..thank you for the post. My requirement is to add a new role with consumer permissions along with permission to add comments and reply to discussions.Needed help on this.
    Thanks in advance

Leave a Reply

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