CHOICE element (List)

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

Used to define a choice within a Choice field.

    Value = "Text">
    Value = "Text">

Elements and attributes

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


Attribute Description
Optional Text. Specifies the display text for the choice.
The value can be a reference to a resource in the format $Resources:String. However, choice values are not supported by the multilingual user interface (MUI). Choice values are initialized in the default language of the website and do not change when a user switches to an alternate language supported by the site.

Child elements


Parent elements


  • Minimum: 0
  • Maximum: Unbounded


Remember that CAML is case-sensitive; the CHOICE and CHOICES elements are in all capital letters.

The CHOICE element contains the value within its body.


The following example defines a Choice field with three choices.

  <CHOICE>Not Started</CHOICE>
  <CHOICE>In Progress</CHOICE>