Use Labels to Identify Instructions

Click here if you are using WordPerfect and the HotDocs Navigation toolbar doesn't appear in your template.

You can assign labels to IF, REPEAT, and SPAN instructions to help you identify pairs or groups of instructions in a text template. When you label fields, you can choose to merge just a numeric name in a field or you can choose to merge a name as well as the level of nesting. This can help you match opening instructions with closing, as well as help you determine the level of nesting within an instruction.

Field labels are merged as comments in the field.

The following example shows a series of nested REPEAT instructions that have been labeled. The first instruction, REPEAT Editor Information, is labeled with the number 1, since it's the first REPEAT in the template. This same instruction is also assigned the level number of L1, since it's the first level of the REPEAT instruction. The END REPEAT is likewise labeled so that you can easily match them when examining the contents of the template.

For each subsequent instruction, HotDocs increments the field number. Additionally, if the next REPEAT instruction is nested (which, in this example, it is), HotDocs increments the nesting level number. Each END REPEAT instruction is likewise labeled.

«REPEAT Editor Information // [1:L1]»

Editor: «Editor First Name» «Editor Last Name»

«REPEAT Author Information // [2:L2]»

Author: «Author First Name» «Author Last Name»

«REPEAT Book Information // [3:L3]»

Title Edited / Date Completed: «Book Title» / «Date Completed:03 JUN 90»

«END REPEAT // [3:L3]»

«END REPEAT // [2:L2]»

«END REPEAT // [1:L1]»

When assigning labels to fields, you can choose whether to include both the field number and the nesting level. You can also choose to merge just one or the other.

Finally, you can have HotDocs assign the hidden text property to these labels (as well as any other comments you've assigned to fields in the template.) When this property is assigned, comments and labels will be hidden and shown, depending on whether you are viewing hidden text in the template. (For information on viewing hidden text, see your word processor's documentation.)

Repeats can not be nested more than four levels deep.

To label instructions

  1. At the text template, click the Label Fields button. The Label Fields dialog box appears.
  2. Select an option, based on the following information:
    • To assign a numeric name to each instruction, select Label IF, REPEAT, and SPAN instructions.
    • To have HotDocs identify the level of nesting for each instruction, select Identify level of nested IF, REPEAT, and SPAN instructions.
    • To apply the hidden text property to comments and labels, select Place comments (including field labels) in hidden text. Once applied, you can quickly show and hide your comments and labels by choosing the appropriate command at the word processor.
  3. Click OK. HotDocs applies the labels you have selected to any instructions in the template.

SPAN fields are supported in Microsoft Word only.

To clear labels from fields or show comments once again, click the Label Fields button, clear all of the options, and click OK.

If you're using Microsoft Word, you can also label fields by clicking on the HotDocs drop-down menu in the HotDocs toolbar and choosing Label Fields.