# mailMerge element

Contains the elements that hold mail-merge information for this document.

## Usage

    <mailMerge />

## Element Information

Element type | mailMergeElt
Namespace | http://schemas.microsoft.com/office/word/2003/wordml
Schema name | XML Document 2003

## Elements and Attributes

### Parent Elements

Element | Description
--- | ---
docPr | Represents the document properties.

### Child Elements

Element | Description
--- | ---
mainDocumentType | Specifies a mail-merge main document type. The main document is the document that contains information that is the same for each version of the merged document -- for example, the return address in a form letter.
linkToQuery | Specifies whether a mail-merge main document contains a query to its data source. If specified, the mail-merge document does not link to the data source by means of Microsoft Query.
dataType | Specifies the type of mail-merge data source (such as an Excel spreadsheet or Access database) and the method of data access (for example, by means of ODBC or DDE).
defaultSQL | Specifies whether the mail merge will use the default SQL query string.
connectString | Represents the connection string used to open an external data source.
query | Contains the query that is run against the data source.
dataSource | Specifies the path to the mail-merge data source.
headerSource | Specifies the path to the mail-merge header source.
doNotSuppressBlankLines | Causes Word not to print blank lines when a data field is empty.
destination | Specifies the output of a mail merge.
addressFieldName | Contains the name of the data field with the destination e-mail or fax address.
mailSubject | Contains the text that appears in the subject line of the mail-merge destination e-mail or fax.
mailAsAttachment | Sends the merged document to e-mail recipients as an attachment.
viewMergedData | Specifies that merge data is displayed.
activeRecord | Specifies the active record that a main mail-merge document displays.
checkErrors | Specifies which mail-merge error checking and reporting option runs. 1) Simulate the merge and report errors in a new document. 2) (default) Complete the merge, pausing to report each error as it occurs. 3) Complete the merge without pausing; report errors in a new document.
odso | Contains settings related to the Office Data Source Object.

### Attributes

None.

## Definition

    <xsd:element name="mailMerge" type="mailMergeElt" minOccurs="0" >
    </xsd:element>

©2003-2004 Microsoft Corporation. All rights reserved. Permission to copy, display and distribute this document is available at: http://msdn.microsoft.com/library/en-us/odcXMLRef/html/odcXMLRefLegalNotice.asp