# Insert a List Item

To insert a list item, the `insertXml` must include the following properties.

`TYPE` | The type of item to insert. To insert a list item, specify `LISTITEM`.
`PATH` | The path, including the list item name, of the list item relative to the root of the list.

You must then specify either (`LISTID`, `SITEID`, and `SITECOLLECTIONURL`) or (`INSERTFROMPATH`, `SITEURL`, and `LISTNAME`).

`INSERTFROMPATH` | To insert a list item by path, set this to `TRUE`.
`LISTID` | The GUID of the list to which you want to add the list item.
`LISTNAME` | The name of the list to which you want to add the list item.
`SITECOLLECTIONURL` | The absolute URL of the site collection to which you want to add the list item.
`SITEID` | The GUID of the site to which you want to add the list item.
`SITEURL` | The absolute URL of the site to which you want to add the list item.

The following properties are optional:

`FSObjType` | An integer that determines how the list item is represented in the file system. If the list item represents a file, specify `0`. If the list item represents a folder, specify `1`.

You can optionally add metadata to the list item.

`[Prefix][FieldName]` | Replace `[Prefix]` with the value of the `ItemFieldNamePrefix` parameter, as set in the configuration file. Replace `[FieldName]` with the name of the field that you want to add, and specify the value.

For example, the value of your `insertXML` action parameter might look like this:

    <insertXML>
      <insert>
        <reference>TEST_LIST_ITEM</reference>
        <property name="TYPE" value="LISTITEM"/>
        <property name="PATH" value="folder/subfolder/item1"/>
        <property name="LISTID" value="26FFE115A45AF1F1"/>
        <property name="SITEID" value="E11526FFA45AF1F1"/>
        <property name="SITECOLLECTIONURL" value="http://sharepoint/SiteCollection/"/>
        <property name="FSObjType" value="1"/>
        <metadata name="MyPrefixMyIntegerField" value="123"/>
      </insert>
    </insertXML>

To insert a list item by path, your XML might look like this:

    <insertXML>
      <insert>
        <reference>TEST_LIST_ITEM </reference>
        <property name="TYPE" value="LISTITEM"/>
        <property name="PATH" value="folder/subfolder/item1"/>
        <property name="LISTNAME" value="MyList"/>
        <property name="SITEURL" value="http://sharepoint/SiteCollection/Site/"/>
        <property name="INSERTFROMPATH" value="TRUE"/>
        <property name="FSObjType" value="1"/>
        <metadata name="MyPrefixMyIntegerField" value="123"/>
      </insert>
    </insertXML>

_FT_HTML5_bannerTitle.htm