Field Codes
- 3 minutes to read
Syntax
Field codes appear between curly brackets ( { } ). 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 | Inserts the current date and time. 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. |
TC | Defines entries for the table of contents. |
TEMPLATE | Inserts the name of a template attached to the document. |
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.