Differences Between INSERT and ASSEMBLE Instructions
The way HotDocs processes an INSERT instruction is different from the way HotDocs processes an ASSEMBLE instruction:
How HotDocs Processes an INSERT Instruction
The INSERT instruction interrupts assembly of the parent template's document (if you place the instruction before the end of the template) to assemble the inserted template . HotDocs inserts the assembled text at the location of the INSERT instruction, and then finishes assembling the parent template's document so that the final output is one seamless document.
How HotDocs Processes an ASSEMBLE Instruction
Unlike the INSERT instruction, when you start a new assembly using the ASSEMBLE instruction, HotDocs adds the template to the Assembly Queue and then waits until the main document finishes assembling before assembling the template the ASSEMBLE instruction references. Each time you send the assembled document to the word processor or to HotDocs Filler , HotDocs creates a separate file, instead of appending assembled documents to the end of the previous document. ASSEMBLE instructions can be used in both text and form templates, and they can add both text and form templates to the assembly queue, regardless of the type of template where the instruction is used.
You can also use an ASSEMBLE instruction to assemble multiple documents from within one template. For example, say providing a particular while assembling a document means the user must then assemble another document. Rather than make the user assemble the second document manually, you can have HotDocs assemble the second document automatically. You do this by using an ASSEMBLE instruction in the template. Once the first assembly finishes, HotDocs starts the second assembly.
To test an ASSEMBLE instruction, you must exit the template completely and test it from the library .