# FieldInsert Method

> Inserts a new marked text field with the given text at the caret position, returns True on success and sets FieldCurrent to the new field's identifier.

- **Product:** TX Text Control ActiveX
- **Section:** Documentation
- **Kind:** Method
- **Path:** TX Text Control ActiveX > API Reference > TXTextControl > FieldInsert Method
- **227 words**
- **Web URL:** https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/fieldinsert-method/
- **LLMs URL:** https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/fieldinsert-method/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/fieldinsert-method/llms-full.txt

---

Inserts a new marked text field at the current caret position.

### Syntax

```vbscript
TXTextControl.FieldInsert FieldText
```

### Parameters

| Parameter | Description |
|---|---|
| FieldText | Specifies the text contents for the new marked text field. |

### Return Value

The method returns True if a field could be inserted, otherwise it returns False.

### Data Types

| Name | Data type |
|---|---|
| FieldText | String |
| Return value | Boolean |

### Examples

See the description of the [FieldCurrent](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/fieldcurrent-property/llms-full.txt) property.

### Remarks

Inserting a marked text field changes the value of the [FieldCurrent](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/fieldcurrent-property/llms-full.txt) property to the identifier of the newly created field.

### See Also

- [Marked Text Fields](https://docs.textcontrol.com/tx-text-control-activex/document-editor/fields/llms-full.txt)
- [Programming Category: Text Fields](https://docs.textcontrol.com/tx-text-control-activex/reference/categories/text-fields/llms-full.txt)

---

## Nearby

- **Previous:** [FieldHighlightTransparency Property](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/fieldhighlighttransparency-property/llms-full.txt)
- **Next:** [FieldLeft Event](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/fieldleft-event/llms-full.txt)