Field Codes
- 3 minutes to read
Syntax
Field codes appear between curly braces ( { } ). You can switch between displaying the field code and the result for a selected field by selecting Toggle Field Codes in the context menu.
When you view a field code in your document, the syntax looks like this:
{ FIELDNAME Properties Optional_Switches }
- FIELDNAME - This is the name of the field.
- Properties - These are any instructions or variables that are used in a particular field. Not all fields have parameters, and in some fields, parameters are optional.
- Optional switches - These are any optional settings that are available for a particular field. Not all fields have switches available, other than those that control the formatting of the field results.
For example, the {MERGEFIELD Weather.condition *Upper} field denotes the MERGEFIELD field bound to the Weather.condition data field, which displays the text in all caps.
Supported Fields
| Field Name | Functionality |
|---|---|
| AUTHOR | Inserts contents of the Author box from the Summary tab in the Document Properties dialog. |
| COMMENTS | Inserts contents of the Comments box from the Summary tab in the Document Properties dialog. |
| CREATEDATE | The date and time when the document was first created. After a mail merge the field is replaced with the date and time of the mail merge operation. |
| DATE | Inserts the current date and time. |
| DOCPROPERTY | Inserts the value of the document property specified by the field parameter. |
| DOCVARIABLE | Enables you to programmatically insert complex content when this field is updated. |
| HYPERLINK | Enables you to navigate to another location or to a bookmark. |
| IF | Compares two values and inserts the text according to the results of the comparison. |
| INCLUDEPICTURE | Inserts the specified image. |
| KEYWORDS | Inserts contents of the Keywords box from the Summary tab in the Document Properties dialog. |
| LASTSAVEDBY | Inserts the name of the last person who modified and saved the document. |
| MERGEFIELD | Retrieves a value from the bound data source. |
| NUMPAGES | Inserts the total number of pages. |
| PAGE | Inserts the number of the page containing the field. |
| PRINTDATE | Inserts the date and time that a document was last printed. |
| REF | Inserts bookmarked text or graphics. |
| REVNUM | Inserts the number of document revisions. |
| SAVEDATE | Inserts the date and time a document was last saved. |
| SECTIONPAGES | Inserts the total number of pages in a section. |
| SEQ | Provides sequential numbering in the document. |
| STYLEREF | Inserts text that is formatted with the specified style. |
| SUBJECT | Inserts contents of the Subject box from the Summary tab in the Document Properties dialog. |
| SYMBOL | Inserts a symbol. |
| TEMPLATE | Inserts the name of a template attached to the document. |
| TC | Defines entries for the table of contents. |
| TIME | Inserts the current time. |
| TITLE | Inserts contents of the Title box from the Summary tab in the Document Properties dialog. |
| TOC | Builds a table of contents. |
Formatting Options
The following format switches are supported.