<mailSubject> (Merged E-mail or Fax Subject Line)

This element specifies the text which shall appear in the subject line of the e-mails or faxes that result after the actions of a mail merge have imported external data into fields within a merged WordprocessingML document whose destination, as specified in the <destination> element (§2.14.21), is email or fax.

If this element is omitted, then no subject line text shall be associated with each merged document produced via a mail merge using the specified mail merge data. If the <destination> element (§2.14.11) specifies that the merged document destination is not email or fax, this element shall be ignored.

example: 
<w:mailMerge>
  …
  <w:destination w:val="email" />
  <w:mailSubject w:val="Example Subject Line" />
  …
</w:mailMerge>

The <mailSubject> element specifies that after the specified external data has been imported into the specified fields in the merged document, each record merged shall result in a single e-mail message, each with their subject line reading Example Subject Line. ]

Parent Elements

<mailMerge> (§2.14.20)

Attributes

Description

<val> (String Value)

Specifies that its contents will contain a string.

The contents of this string are interpreted based on the context of the parent XML element.

<w:pPr>
  <w:pStyle w:val="heading1" /> 
</w:pPr>

The value of the @val attribute is the ID of the associated paragraph style's styleId.

However, consider the following fragment:

<w:sdtPr>
  <w:alias w:val="SDT Title Example" />
  ...
</w:sdtPr>

In this case, the decimal number in the @val attribute is the caption of the parent structured document tag. In each case, the value is interpreted in the context of the parent element. ]

The possible values for this attribute are defined by the ST_String simple type (§2.18.89).

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_String">
	<attribute name="val" type="ST_String" use="required"/>
</complexType>