Trellis White paper Ad 770 Spot #6
hotdocs software
share TWEET PIN IT share share 0
Tech Tips

How to Insert Variables in HotDocs

By Danielle DavisRoe

HotDocsHotDocs document automation templates allow you to customize document fields in a variety of useful ways. The following excerpt from Affinity Consulting Group’s “HotDocs for Legal Professionals” walks you through the multiple ways to insert variables into your HotDocs software templates.

Open Your Template

Once you’ve started your document template, the first step is to start replacing changeable text with HotDocs variables. Examples of changeable text include names, dates, pronouns, numbers and calculations. A variable is what prompts HotDocs to ask for the information that is used to assemble a document.

Variable Types in HotDocs Software

HotDocs software allows you to create seven different types of variables: Text, Number, Date, True/False, Multiple Choice, Computation and Personal Information. The type of variable you create determines the type of information the user can enter. For example, if you create a date variable, the users must enter a valid date — they cannot enter text, such as a name, for an answer.

Two Parts of a Variable

There are two parts to creating variables: Creating the variable component and creating the variable field.

Variable Component

The variable component is the core part of a HotDocs variable. It contains all the information about a variable, how it should be processed, including the component name and prompt, any Resource information, and any special patterns or other options that help control how the variable appears during the interview and how it will be processed when the final document is assembled. These are stored in the component file.

Variable Field

When you insert a variable component into a HotDocs template, HotDocs creates a field. This is where the information is merged into the assembled document. In a text template, the field is denoted by HotDocs chevrons (« »). There are certain properties that are assigned to a variable’s merge field that affect the way the variable is merged into the document — specifically, formats and merge text for Multiple Choice variables.

How It Happens

When you insert a variable directly into the template, you automatically create a variable component and field for the variable.

However, when you create a variable using Component Manager, there is no variable field associated with the variable until the variable is inserted into the template.

Naming Variables

Variable names can be up to 50 characters long, so be descriptive. Note, however, that names MUST begin with a letter — names may contain numbers but may not begin with one.

Things to Avoid When Naming Variables

  • Do not use punctuation in variable names.

Incorrect: «Client’s Name»

Correct: «Client Name»

  • Only use letters or numbers in the variable names.

Incorrect: «Payor/Mortgagor»

Correct: «Payor or Mortgagor»

  • Do not use all capital letters in variable names.

Incorrect: «CLIENT NAME»

Correct: «Client Name»

Good Ideas for Variable Naming

Always precede the variable name with the party or thing it’s relevant to. For example, if I was creating a template for a deed, I would call my variables «Grantor Name First», «Grantor Name Middle», «Grantor Name Last», «Grantee Name First», «Grantee Name Middle» and «Grantee Name Last».

If you’re creating a promissory note template, then you might have variables called «Note Interest Rate», «Note Payment Amount», «Note Commencement Date», «Note Maturity Date», etc.

Create Prompts for Each Variable

Type the question that you’d like the user to answer during assembly.

Steps for Inserting Variables

To insert a variable into your template, follow these steps:

  1. Select the text you want to replace with a variable.
  2. Click the variable button on the HotDocs toolbar.
  3. Choose the appropriate type of variable, and click the Edit Component button.
  4. Provide a name and prompt (question) and click OK.
  5. You will be prompted to replace one (only the text you selected) or replace multiple. If you choose Replace Multiple, you will be prompted to replace each instance of the selected text in the template or replace all instances of the selected text in the template.

Caution: When replacing all, HotDocs will often replace text with a variable you didn’t intend to replace. It’s always safer to click plain Replace, which causes it to automatically jump to the next instance of the word or phrase you’re replacing and gives you the opportunity to Replace or Find Next (don’t replace).

About Affinity Consulting Group

Affinity Consulting Group inspires, enables, and empowers legal teams of all sizes to work smarter, from anywhere. The company’s holistic approach incorporates people, processes, and technology. Affinity’s passionate, well-connected industry experts work hand in hand with you to help you better understand and optimize your business — from software to growth strategy and everything in between.

Illustration ©

You Might Also Like

“Advanced Placement: The New HotDocs Is a Bold Reimagining” by Jared Correia

“Microsoft Word for Legal Professionals (Windows and Office 365)”

“Five Easy Steps to Redact Sensitive Information in Adobe Acrobat Professional”

“How to Master Page Numbering in Microsoft Word”

Subscribe to Attorney at Work

Get really good ideas every day for your law practice: Subscribe to the Daily Dispatch (it’s free). Follow us on Twitter @attnyatwork.

Categories: Legal Software, Legal Technology, Office 365, Tech Tools
Originally published June 2, 2022
Last updated June 20, 2022
share TWEET PIN IT share share
Danielle Danielle DavisRoe

Danielle DavisRoe is a senior consultant with Affinity Consulting Group (@affinitylegal). Whether it’s teaching clients a new skill through training, speaking at CLE events, or management consulting, Danielle is 100% focused on making the lives of her clients better. She has a Bachelor of Science in Business Administration from The Ohio State University Fisher College of Business and a Juris Doctorate from The Ohio State University Moritz College of Law.

More Posts By This Author
MUST READ Articles for Law Firms Click to expand

Welcome to Attorney at Work!

Sign up for our free newsletter.


All fields are required. By signing up, you are opting in to Attorney at Work's free practice tips newsletter and occasional emails with news and offers. By using this service, you indicate that you agree to our Terms and Conditions and have read and understand our Privacy Policy.