# TXTextControl.MergeField Object

> Represents an MS Word specific MERGEFIELD field. Is used as a parameter for the addMergeField method.

- **Product:** DS Server
- **Section:** Reference
- **Kind:** Object
- **Introduced:** 25.0
- **Path:** DS Server > Reference > JavaScript API > TXTextControl.MergeField Object
- **602 words**
- **Web URL:** https://docs.textcontrol.com/ds-server/reference/javascript/txtextcontrol-mergefield/
- **LLMs URL:** https://docs.textcontrol.com/ds-server/reference/javascript/txtextcontrol-mergefield/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/ds-server/reference/javascript/txtextcontrol-mergefield/llms-full.txt

---

### Description

Represents an MS Word specific MERGEFIELD field. Is used as a parameter for the [addMergeField](https://docs.textcontrol.com/ds-server/reference/javascript/txtextcontrol/addmergefield-method/llms-full.txt) method.

### Syntax

```javascript
TXTextControl.MergeField
```

### Examples

The following example demonstrates `TXTextControl.MergeField` in a practical document-editing workflow. It represents an MS Word specific MERGEFIELD field. Is used as a parameter for the addMergeField method.

```javascript
function inspectMergeField(mergeField) {
    console.log("TXTextControl.MergeField object:", mergeField);
}
```

---

## In This Section

- [Javascript: TXTextControl.MergeField.dateTimeFormat Property](https://docs.textcontrol.com/ds-server/reference/javascript/txtextcontrol-mergefield/datetimeformat-property/llms-full.txt): Specifies a string format which is applied to date / time values. Is equivalent to the MS Word field flag “\​@”.
- [Javascript: TXTextControl.MergeField.name Property](https://docs.textcontrol.com/ds-server/reference/javascript/txtextcontrol-mergefield/name-property/llms-full.txt): Specifies the name of the field.
- [Javascript: TXTextControl.MergeField.numericFormat Property](https://docs.textcontrol.com/ds-server/reference/javascript/txtextcontrol-mergefield/numericformat-property/llms-full.txt): Specifies a string format which is applied to numeric values. Is equivalent to the MS Word field flag “\#”.
- [Javascript: TXTextControl.MergeField.preserveFormatting Property](https://docs.textcontrol.com/ds-server/reference/javascript/txtextcontrol-mergefield/preserveformatting-property/llms-full.txt): Specifies whether the field's formatting should be preserved.
- [Javascript: TXTextControl.MergeField.text Property](https://docs.textcontrol.com/ds-server/reference/javascript/txtextcontrol-mergefield/text-property/llms-full.txt): Specifies the text of the field.
- [Javascript: TXTextControl.MergeField.textAfter Property](https://docs.textcontrol.com/ds-server/reference/javascript/txtextcontrol-mergefield/textafter-property/llms-full.txt): Specifies the text of the field that is displayed after the field's text.
- [Javascript: TXTextControl.MergeField.textBefore Property](https://docs.textcontrol.com/ds-server/reference/javascript/txtextcontrol-mergefield/textbefore-property/llms-full.txt): Specifies the text of the field that is displayed before the field's text.
- [Javascript: TXTextControl.MergeField.textFormat Property](https://docs.textcontrol.com/ds-server/reference/javascript/txtextcontrol-mergefield/textformat-property/llms-full.txt): Specifies the text format of the field. Possible values are defined in TXTextControl.MergeFieldTextFormat.

---

## Nearby

- **Previous:** [Javascript: TXTextControl.MeasuringUnit Enumeration](https://docs.textcontrol.com/ds-server/reference/javascript/txtextcontrol/measuringunit-enumeration/llms-full.txt)
- **Next:** [Javascript: TXTextControl.MergeField.dateTimeFormat Property](https://docs.textcontrol.com/ds-server/reference/javascript/txtextcontrol-mergefield/datetimeformat-property/llms-full.txt)