List Instances

Applies to: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

The ListInstance element specifies default data with which to provision the given list type. This element maps to the List element previously located within the Configuration element in Onet.xml.


When a list instance is provisioned in a Feature, the Title attribute must be specified and unique.


The following example shows the contents of an XML file in which the ListInstance element is used to specify default data for a list instance.

    <?xml version="1.0" encoding="utf-8" ?>
    <Elements xmlns="">
          Id="WssAdminTasks" Title="Administrator Tasks"
          Description="Create an Administrator Tasks list to track a group of admin work items."
          TemplateType="1200" Url="Lists/AdminTasks">
                   <Field Name="Action">/_admin/globalemailconfig.aspx?Source=/default.aspx, Configure Outgoing E-Mail Settings</Field>
                   <Field Name="Description">Specify the SMTP email server to use for alerts and administrator notifications.</Field>
                   <Field Name="Title">Outgoing email settings</Field>
                   <Field Name="SystemTask">True</Field>
                   <Field Name="Priority">01</Field>
                   <Field Name="Service">SMTP</Field>

See also