ListInstance Element (List Instance)

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

Specifies default data with which to provision the given list type.


  CustomSchema = string
  Description = "Text"
  DocumentTemplate = integer
  FeatureId = "Text"
  Hidden = "TRUE" | "FALSE"
  HyperlinkBaseUrl = string
  Id = Text
  OnQuickLaunch = "TRUE" | "FALSE"
  QuickLaunchUrl = "Text"
  RootWebOnly = "TRUE" | "FALSE"
  TemplateType = Integer
  Title = "Text"
  Url = "Text"
  VersioningEnabled = "TRUE" | "FALSE"

Elements and attributes

The following sections describe attributes, child elements, and parent elements.


Attribute Description
CustomSchema Optional string. Specifies the custom schema to use for the list instance.
Description Optional Text. Contains a description of the list.
DocumentTemplate Optional string. Specifies the document template to use for the list instance.
FeatureId Required Text. Specifies the GUID of the Feature. If you do not specify a Feature GUID, Microsoft SharePoint Foundation uses the ID of the default Feature, in other words, the one containing the ListInstance element. If the list template for the list instance is contained within a different Feature, you must specify the ID of that Feature through the FeatureId attribute.
Hidden Optional Boolean. Specifies if the list is hidden.
HyperlinkBaseUrl Optional string. Specifies the absolute URL used for hyperlinks in the list.
Id Optional Text. Specifies a unique identifier for the list instance. The integer must be unique across the Feature definition.
OnQuickLaunch Optional Boolean. TRUE to display lists created from the list definition on the Quick Launch bar.
QuickLaunchUrl Optional Text. Specifies the URL of the view page to open for the list through Quick Launch navigation.
RootWebOnly Optional Boolean. TRUE to specify that the list created from the definition exists only in the root website of a site collection.
TemplateType Required Integer. Returns the integer identifier of the list template to use.
Title Required Text. Title of the list in the schema. This must also be unique.
Url Required Text. Returns the site-relative URL at which to place the list.
VersioningEnabled Optional Boolean. Specifies if versioning is enabled on the list.

Child elements

Data, DataSource Element (List Instance)

Parent elements



  • Minimum: 0
  • Maximum: Unbounded


The ListInstance Feature element maps to the List element as used in SharePoint Foundation within the Configuration element in onet.xml.


For an example of how this element is used, see List Instances.