Max Occurs (Node Property of All Schemas)


Use the Max Occurs property to configure the maximum number of times that the element or elements corresponding to the selected node can occur in a given scope in an instance message.


If an ancestor node can occur multiple times, the total occurrences of the selected node can be greater than the occurrence range specified by the values of the Min Occurs property and this property.

Applies to Nodes of Type

Record, Field Element, Sequence Group, Choice Group, All Group, Any Element



Allowed Values

Edit box value Description
Non-negative integer Any value greater than one (1) will enable the corresponding element(s) in an instance message to occur up to that many times. To prohibit multiple occurrences, set the value of this property to one (1) or leave it blank. To prevent all occurrences, set the value of this property to zero (0).

The maximum value for Max Occurs is 4095. If you need a value greater than this, use "unbounded" as described below.

Use this value if you do not know how many loops you might have in an instance message and you do not want to lose any data. An asterisk (*) is a BizTalk Editor abbreviation for the literal string value "unbounded".
No value Use this property value to restore the behavior to the default value of one (1).

Default Value

No value, indicating the default behavior associated with the value one (1).

XSD Persistence

As the value of the maxOccurs attribute of the element that corresponds to the selected node.


The literal string "unbounded", and not an asterisk (*), is persisted in the XSD.


You can examine and set this property in the Visual Studio Properties window when you select a node of an appropriate type in BizTalk Editor.

This property represents a standard XSD construct. For additional information about the corresponding XSD construct, see XSD Resources on the Web.

When you set this property to any value other than 1, BizTalk Mapper compiles the selected node as a looping record. If you configure this property with a value of 1, BizTalk Mapper will not compile the selected node as a looping record.

See Also

Node Properties of All Schemas