Change the default settings for newly created SharePoint Document Library

Thought it would be helpful to share this.

As you know, SharePoint Document Library by default, if you just simply create one, are not turned on with Version Control. This could rather prone to human mistake or mis-configuration whenever you need to provision a new document library.

This is how I fulfill this.

Imagine i need to have the version control turn on, and with the following settings

version history limits

What you need to do is to create a custom event receiver with List Added handler

Fire up your Visual Studio, create a SharePoint Farm solution and add your new event receiver

New Event Receiver

Select List Events and tick “A list was added”

Event Receiver Setting

In the ListAdded method, kindly do a checking before the code is firing, the below TemplateId 101 means Document Library

[sourcecode language=”csharp”]

if (properties.List != null && properties.TemplateId == 101 && properties.Web != null)

SPList docList = properties.List;//.Lists[properties.ListId];
docList.EnableVersioning = true;
docList.EnableMinorVersions = true;
docList.MajorVersionLimit = 3;
docList.MajorWithMinorVersionsLimit = 20;

//this.EventFiringEnabled = false;
catch (Exception ex)

//Do something…




If you do this, you will hit this error when creating a new document library

The security validation for this page is invalid. Click Back in your Web browser, refresh the page, and try your operation again.

This is due to the Synchronisation mode for ListAdded event by default is “Asynchronous”.
You MUST DO the following

Open the Element.xml created via Visual Studio.
Add a “<Synchronization>Synchronous</Synchronization>” node into your receiver xml

[sourcecode language=”xml”]

Deploy your solution and hooray~

Leave a Reply

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