Field Object (Word)

Office 2013 and later

Contribute to this content

Use GitHub to suggest and submit changes. See our guidelines for contributing to VBA documentation.

Represents a field. The Field object is a member of the Fields collection. The Fields collection represents the fields in a selection, range, or document.

Use Fields(Index), where Index is the index number, to return a single Field object. The index number represents the position of the field in the selection, range, or document. The following example displays the field code and the result of the first field in the active document.

If ActiveDocument.Fields.Count >= 1 Then 
 MsgBox "Code = " & ActiveDocument.Fields(1).Code & vbCr _ 
 & "Result = " & ActiveDocument.Fields(1).Result & vbCr 
End If

Use the Add method to add a field to the Fields collection. The following example inserts a DATE field at the beginning of the selection and then displays the result.

Selection.Collapse Direction:=wdCollapseStart 
Set myField = ActiveDocument.Fields.Add(Range:=Selection.Range, _ 
MsgBox myField.Result
Note Note

The wdFieldDate constant is part of the WdFieldType group of constants, which includes all the various field types.