How To: Create custom content type and list instance in SharePoint 2010 using Visual Studio 2010

There are many blogs and MSDN articles talking about the same topic but I decided to write my own one as I did not get a satisfying explanation of why adding the codes here and there when the articles told me to. I believe what I am trying to achieve here is quite simple and common:

1. Create a content type which is reusable

2. Create a list using the content type created in (1)

3. Changes the default “Title” field’s display name (I will discuss this in a separate post)

Below is the step by step instruction of how to achieve the above tasks and some explanations (to the extends of my knowledge) as why we do it the way described. With Visual Studio 2010, SharePoint developers no longer need to manually create feature and element file, packing the feature into a solution file (wsp) and deploying. All those jobs are now automated by Visual Studio 2010 so we can just focus on our tasks of creating custom content types and list instances.

1. Create a new Visual Studio 2010 project

For the purpose of this demo, we will create a project called “Color” which will hold our color content type and color list using the content type and eventually the feature event receiver will insert some initial list items when the feature was activated.

  1. in VS2010, click [File] –> [New] –> [Project]
  2. In the “Installed Template” pane, select [Visual C#] –> [SharePoint] –> 2010
  3. Make sure [.NET Framework 3.5] is selected as the framework type and click on [List Definition].
  4. Enter “Color” in the Name field, click OK button
  5. Enter the URL of the site that this solution/feature will be installed (http://SP2010Demo) and select [Deploy as a farm solution] and click Next button.
  6. Select [Custom List] in the drop down list as the type for the list definition and ensure the checkbox [Add a list instance for this list definition] is check, then click Finish button. You should see something similar in solution explorer to the below screenshot.


  • ListDefinition1/Elements.xml is where you define your custom content types and list templates.
  • ListDefinition1/Schema.xml is where you define the view and fields for that list only and as well as applying the content types that you created in ListDefinition1/Elements.xml.
  • ListDefinition1/ListInstance1/Elements.xml is where you define the list instance and apply list template type.

2. Create a custom content type

We will create a Color content type with 3 fields/columns to store the color’s name, RGB value and Hex value. Since we used Custom List as the base type for the list definition, we have Title column by default and there is no need to create one. However we do need to rename “Title” to “Color Name” and we will look into that later.  

  1. Open ListDefinition1/Elements.xml
  2. To declare the fields, insert the following lines in the <Elements> tag and before <ListTemplate> tag. The IDs were generated using GUID  Generator. You can open GUID Generator by going to [Too ls] > [Create GUID] and select format 4.

    Field ID={168076D8-500B-4572-B2FA-9CC9C4664F4C}Type=TextName=RGBValueDisplayName=RGB ValueRequired=TRUESealed=TRUE/>
    Field ID={A97BDC8C-8723-455E-818C-56CE8D63BE19}Type=TextName=HexValueDisplayName=Hex ValueRequired=TRUESealed=TRUE/>
  3. To declare the content type, insert the following lines  after the above lines. ugain, Use GUID Generator for ContentType ID. Notice that we are simply attaching the Fields that we created in step 2 above inside <FieldRefs> tag for them to be included in the content type.

    ContentType ID=0x0100736C62A68F6A408E8D0800B14AF43E0EName=ColorsGroup=Custom CTDescription=Color content type>
    FieldRef ID={168076D8-500B-4572-B2FA-9CC9C4664F4C}/>
    FieldRef ID={A97BDC8C-8723-455E-818C-56CE8D63BE19}/>
  4. Modify <ListTemplate> tag so it looks like below. The value of “Type” is the identifier for the template and needs to be unique within the feature. Normally I choose numbers larger than 10000 for it. I’ve also added DisallowContentTypes=”False”. See ListTemplate Element (List Template) for more detailed explanations.

            DisplayName=Color – ListDefinition1
            Description=My List Definition

  5. Now your Elements.xml file should look something like below:

3. Apply custom content type in list definition (Schema.xml)

  1. Open ListDefinition1/Schema.xml
  2. Remove the following 2 <ContentTypeRef> tags from <ContentTypes> tag
    <ContentTypeRef ID=0x01>
    ContentTypeRef ID=0x0120/>
  3. Add the following <ContentTypeRef> tag into <ContentTypes> tag

    <ContentTypeRef ID=0x0100736C62A68F6A408E8D0800B14AF43E0E></ContentTypeRef>

  4. Here is the tricky part, although we have declared the fields RGBValue and HEXValue in the Color content type already, we still need to declare them in the list definition again. This is somehow SharePoint was designed. Please see Difference between declaring fields in content types and in list definition. Insert the following lines within <Fields> tag. Those are exactly the same lines as in the content type Elements.xml file.

    <Field ID={168076D8-500B-4572-B2FA-9CC9C4664F4C}Type=TextName=RGBValueDisplayName=RGB ValueRequired=TRUESealed=TRUE/>
    Field ID={A97BDC8C-8723-455E-818C-56CE8D63BE19}Type=TextName=HexValueDisplayName=Hex ValueRequired=TRUESealed=TRUE/>

  5. Add EnableContentTypes=TRUE”  attribute to the <List> tag
  6. Now adding the two fields into list’s default view. Find the <View> tag with BaseViewID=”1’” and change <ViewFields> tag so it looks like

    FieldRef Name=LinkTitle></FieldRef>
    FieldRef Name=RGBValue></FieldRef>
    FieldRef Name=HexValue></FieldRef>

  7. Now your Schema.xml file should look like below:

4. Modify ListInstance1/Elements.xml File

  1. Open ListInstance1/Elements.xml file
  2. Modify the <ListInstance> tag so it looks like below

    <?xml version=1.0encoding=utf-8?>
    Elements xmlns=>
    ListInstance Title=Color
                    Description=A list for colors>
    Notice that we are telling the list instance to use list template with Type ID 10050.


5. Feature Settings

We will change a few feature properties to make it more sensible

  1. Double click on Features/Feature1
  2. Change the Title field to “Color Demo”. This will be the feature name that you see in site collection features page.
  3. Change the Scope drop down list to “Site”. We want to make this feature available at the site collection level instead of the web.
  4. Right click on Features/Feature1 > Properties. In the Properties window, change the Folder Name to “ColorDemoFeature”
  5. At this point, the feature folder name will be “Color_ColorDemoFeature” under the 14 hive. (14\TEMPLATE\FEATURES). To change this, double click on Features/ColorDemoFeature/ColorDemoFeature.feature. In the Properties window, there is a property called “Deployment Path”. By default, it’s set to
    As you can see
    $SharePoint.Project.FileNameWithoutExtension$ = Color
    $SharePoint.Project.FileNameWithoutExtension$ = ColorDemoFeature

    You can play around with this to get your desired feature name sitting in the 14 hive.


6. Deployment

This is where the fun starts. Just one click and VS2010 get it done for you!

  1. Double check that we have the correct deployment settings before we start by clicking on the project name Color. In the Properties window, it should have Site URL property set to http://SP2010Demo and Sandboxed Solution set to FALSE.
  2. Right click on the project name Color, then click Deploy. It will go through the following stages to install the solution and features depends on whether it’s the first time you are doing the deployment.

    Build Started …
    Deploy Started …
    Run Pre-Deployment Command
    Recycle IIS Application Pool
    Retract Solution
    Add Solution
    Activate Features
    Run Post-Deployment Command
    Deploy Succeeded

    You can open the Output windows (View > Output) to see more details.



  1. You may download the complete Visual Studio 2010 solution file from HERE
  2. See How to change default Title field name in the custom content type
  3. Difference between declaring fields in content types and in list definition
  4. MSDN article about ListTemplate Element (List Template)

Feel free to send me any comment or question.


2011-01-18    Updated the solution file. (Removed Post-deployment command line setting I left in the solution)

Comments (27)

  1. Thomas says:

    Hi, nice guide, but it does not work (for me at least). All I get is an "Invalid field name" error when I try to deploy. Also, why do you write out the content type directly in the list definition elements.xml? Is it not possible to use the Add -> Content Type feature in Visual Studio?

    Do you have any tips on where I might find some good documentation on the different tags in the elements.xml (and other sharepoint xml documents for that matter)? I've google for ages and not found anything.

  2. TonyZ says:

    oh man, that's what I'm looking for. Are you are SharePoint master? Thanks a lot!

  3. AllenWang says:

    Hi Thomas, I believe the error "Invalid field name" comes up when it's trying to "activate feature". One thing to check is at step 2.3 above. Check if <ContentType> tag  contains "Inherits=true" property, if yes, then try to remove it (I am not sure why setting Inherits=true would cause an error, yet to find out). Or you can try to download the solution file in the References section or pack up your solution and email me at

    For your 2nd question, yes it is possible to use Add -> Content Type feature to create the custom content types. Supposedly, by creating custom type this way, you are writing a content type that's reusable by other lists.

    Based on MSDN article (…/ms463016.aspx), it states:


    You can create a content type collection for a new list as part of the list definition before list instances are provisioned. Within the list definition's ContentTypes element, you can reference existing site content types and you can also define new content types. In this case, the new content types are available only to list instances created from the same list definition. The new content types are not part of the site collection and are not available to other lists.


    However it not what it seems when I deployed it. Both methods achieved the same result of adding the custom content types into Site Content Type gallery. Therefore to me, it's just a matter of which Elements.xml that you write your content type in.

    Here are some MSDN articles:

    Content Types (…/ms479905.aspx)

    Creating Content Types (…/ms460224.aspx)

    ContentType Element (ContentType) (…/aa544268.aspx)

    Site and List Content Types (…/ms463016.aspx)

    How to: Add a Content Type to a List (…/aa543576.aspx)

    Understanding Schema.xml Files (…/ms459356.aspx)

  4. Frustrated SharePoint dude... says:

    I am getting Invalid Field name when trying to create a Site Content Type in code… I was hoping this would help, but it doesn't…

  5. AllenWang says:

    Hi Frustrated SharePoint dude,

    I don't know how you defined the content type, but here are a few common things that you can try about Invalid Field name:

    • Reset IIS before you redeploy the solution

    • Try using another GUID for the invalid field

    • Check if you have the same content type deployed using a different feature. Sometimes I wrap one particular content type in a new feature for debugging purpose.

  6. Phat says:

    Great post! I have a question. Lets say I would like to build a custom Content Type  and upon creating that new Content Type in a document library, it will also create a couple of folders in it. Can it be done using Visual Studio 2010? If yes, would be cool if you can also provide some steps =) Many thanks!

  7. Bastiaan Jacobs says:

    I have an Item in a SharePoint list. Is it possible to update this Item after an Column update?

    Now I have to go to the Column and "Save" it so it will update all list columns based on this site column. (last column option).


  8. seema khaire says:

    this is what i was looking for..

    but when i tried to deploy the solution i got this error…Error occurred in deployment step 'Activate Features': Value does not fall within the expected range.

    Do u have any solution for this?where i did the mistake??

  9. mth says:

    could  you please give me advice ..

    Error 5 Error occurred in deployment step 'Run Post-Deployment Command': The command "c:WarmUpServerStartUp.bat" exited with error code: 3.

    —— Build started: Project: Color, Configuration: Debug Any CPU ——

     Color -> C:MAY_WORKresourcesList and ContentType412.ColorColorColorbinDebugColor.dll

     Successfully created package at: C:MAY_WORKresourcesList and ContentType412.ColorColorColorbinDebugColor.wsp

    —— Deploy started: Project: Color, Configuration: Debug Any CPU ——

    Active Deployment Configuration: Default

    Run Pre-Deployment Command:

     Skipping deployment step because a pre-deployment command is not specified.

    Recycle IIS Application Pool:

     Skipping application pool recycle because no matching package on the server was found.

    Retract Solution:

     Skipping package retraction because no matching package on the server was found.

    Add Solution:

     Adding solution 'Color.wsp'…

     Deploying solution 'Color.wsp'…

    Activate Features:

     Activating feature 'ColorDemoFeature' …

    Run Post-Deployment Command:

    The system cannot find the path specified.

    Error occurred in deployment step 'Run Post-Deployment Command': The command "c:WarmUpServerStartUp.bat" exited with error code: 3.

    ========== Build: 1 succeeded or up-to-date, 0 failed, 0 skipped ==========

    ========== Deploy: 0 succeeded, 1 failed, 0 skipped ==========

  10. MTH says:

    now i cannot access the http://vm-pphg-sp01:81/_layouts/mngfield.aspx

    pls give me any suggestion

  11. AllenWang says:

    Hi MTH,

    The error you had in 'Run Post-Deployment Command' was caused by not having a warm up script at c:WarmUpServerStartUp.bat. I used that script (provided by Joel Oleson @ Warm Up your SharePoint Servers… ) to start up IIS worker process after IISRESET.

    My apology for not removing this from my solution. To remove the Post-Deployment Command, follow the below steps:


    1. right click on 'COLOR' project folder in Solution Explorer -> Properties

    2. click on ‘SharePoint’ from the left hand side menu

    3. clear/remove ‘c:WarmUpServerStartUp.bat’ under ‘Post-deployment Command Line’ section.

    MTH, other than the above issue, the solution was built and deployed successfully. Go to your site’s site collection feature and see if you can see the feature ‘Color Demo’.



  12. AllenWang says:

    Hi Phat,

    Normally I would prefer to create folders/list items using Feature Receiver. However creating folder in List Instance is also possible, except when your list is a custom list based on the below blog:…/Deploy-a-Custom-SPList-with-folders-from-onetxml.aspx

    I haven’t actually tried it yet, but that post should give you enough code example to start with. (or more keywords for your research)



  13. Kurt says:


    How do I generate an ID like: 0x0100736C62A68F6A408E8D0800B14AF43E0E

    With GUID Generator, I can only generate IDs in the format {8CA3CF05-0337-4414-ACAF-04BCE31EADAC}

    Thanks in advance!

  14. Kurt says:

    Just a few additional remarks:

    I got the same error reported by Thomas (first reply) "invalid file name" and it is because the attribute "Name" in the ListTemplate tag (in the file ListDefinition1/Elements.xml) has been renamed to "Color".

    I've set it back to "ListDefinition1" and everything worked. Not sure why?

    Then I think you have a typo in step 5.5:

    $SharePoint.Project.FileNameWithoutExtension$ = ColorDemoFeature

    should be

    $SharePoint.Feature.FileNameWithoutExtension$ = ColorDemoFeature

    (note Project changed into Feature)



  15. Kurt says:

    Ok for resolving the "invalid file name", you need to make sure that the Name attribute is equal to the name of the ListDefinition in the Solution Explorer.

    I've set the name attribute to "Color", and renamed the "ListDefinition1" as well and then deploying works fine.

    For the problem reported by seema khaire (Value does not fall within the expected range):

    I had this one as well, and it was because I had an invalid ContentType ID set. I copied the ID from the description here, and then it worked.

  16. Abhijith Shastry says:

    Hi Allan,

    How do I deploy a custom 'EditForm.aspx' and 'DispForm.aspx'

    using the ListDefinition Template provided by Visual Studio 2010.

    By default these forms do not appear in the solution created from this template.

    But these are available in the Visual Studio 2008 Sharepoint List Definition template.



  17. sudheer says:

    Hi allen,

    I encountered exactly the same error as "seema khaire".

    May i know how can it be resolved?



  18. Sudheer says:

    Hi Allen,

    Thanks for such a nice post and sorry for posting question earlier without checking my solution…..

    (@Seema Khaire:) Actually the mistake was due to the invalid GUID in the content type tag of  ListDefinition1Elements.xml and ListDefinition1Schema.xml.

    Instead of  <ContentTypeRef ID="0x0100C8AA1B28891B47DF9B99F1257AEEB3AC"></ContentTypeRef> , i placed like <ContentTypeRef ID="0x0100C8AA1B28-891B-47DF-9B99-F1257AEEB3AC"></ContentTypeRef> .



  19. hi i am still confused. why we are adding the <Fields> in Schema.xml file though we are referenced the 'Content Type'. i thing the contentype indirectly referncing the fileds in 'Site Columns'.

    don't you think declaring All fields in <Fields> tag will create a local 'column' instead of site Columns'

  20. Nicolai Danielsen says:

    I've had the "Error occurred in deployment step 'Activate Features'", and I found that aften changing the ListTemplate property Type=10050 back to 10000 as VS2010 sets as default, my project runs again.

  21. Steven Andrews says:

    Good introductory post, although some of the comments posted thus far suggest it can possibly be edited again.  There's a technet article that covers a similar topic which may be wirth looking at.

    If I can find it, I'll post the link.

  22. Monty says:

    I am trying to create multiple content types for a List where user is able to select the content type when adding a new item. I have done this on a Document library where after uploading an item, you can toggle the content type and see the fields updated on the form before your eyes. The regular list has a selection under the new arrow, but no toggle or showing of content type on the form. Is there any way to do this without custom coding?

  23. MarkHazleton says:

    Thank you!  Well written, easy to follow and to the point.  

  24. Why not we create the list in SharePoint OOB first and then export it as list intance….how about this approach. What is the best approach for installing SharePoint lists???

  25. Amer Jamaeen says:

    Thanks a lot

    i tried this and it;s working.

    i think you can solve the problem by using

      public override void FeatureActivated(SPFeatureReceiverProperties properties)


               SPSite site = (SPSite)properties.Feature.Parent;

               if (site != null)


                   using (SPWeb web = site.RootWeb)


                       web.ContentTypes["Your Content Type Name"].Update();




  26. Amer Jamaeen says:

    There is very easy solution no need to copy fields in step number 3

    you said :

    "Here is the tricky part, although we have declared the fields RGBValue and HEXValue in the Color content type already, we still need to declare them in the list definition again. This is somehow SharePoint was designed. Please see Difference between declaring fields in content types and in list definition. Insert the following lines within <Fields> tag. Those are exactly the same lines as in the content type Elements.xml file."

    But  SharePoint not working like that  and you can use this to solve your problem

         <ContentType ID="ContentTypeId " Group="ContentTypeGroup" Name="ContentTypeName" >




     for example

         <ContentType ID="0x0100fc51e900668d4e3f92c5458f11b6f34202" Group="News" Name="Local News" >




  27. Chris says:

    You should create the Content Type in code first, then add a list instance to your project using the Content Type you have just created.

    This saves lots of time doing unnecessary work adding the fields to the Schema.xml of the list definition!