Before you start
This article is for anyone fine tuning a custom document in Document Builder, on a computer at app.gohappydoc.com.
You need a custom document to work on. Built in documents like HappySOAP can't be changed, so copy one first. See Document Builder: Create a Custom Note 🛠️.
To open it: Settings, then Documents, click the three dots next to your document and choose Edit Document.
Step 1: Set up the whole document
Click the arrow next to Advanced Settings, just under the name and description boxes at the top of the builder.
Switch on Bold field titles to make every field title bold in the note.
Choose an Output language to have HappyDoc write the whole document in another language, such as Español, Français or Deutsch. There are more than 20 to choose from.
Type any Custom instructions for the whole document, for example "Always refer to the owner as the client."
Click Save at the top right.
Step 2: Open the settings for a section or field
Click a section (or a field inside it) to open it.
Click the arrow next to its Advanced Settings.
You'll see Display Title, Display Output, Custom Instructions, If Discussed and, on many fields, If Not Discussed. Each is explained below.
Step 3: Show or hide the title and the output
Leave Display Title on and switch Display Output off to turn a field into a header: the title shows, the content doesn't.
Switch Display Title off and leave Display Output on to show only the content, with no label in front of it.
For example, keep your section called Subjective but list the questions you ask during history taking as their own fields underneath. HappyEmail works the other way: its titles are hidden so only the paragraphs show.
Alternatively, titles for the HappyEmail template are hidden, for example, so that only the output will show as new paragraphs.
Step 4: Choose what to write when something is discussed
In the exam you might say "Fluffy's heart sounds great" rather than "No murmur or arrhythmia auscultated." If Discussed decides which one ends up in the note.
Open If Discussed on the field.
Choose Display discussed value always to write exactly what was said, normal or not. This is the default for fields outside the physical exam. For example, a 55 lb border collie gets "55 lbs" in Weight even if that's normal for her.
Or choose Display discussed value if abnormal, otherwise use normal value. A Normal Value box appears.
Type your normal wording in Normal Value, for example "No murmur or arrhythmia auscultated." If you say the heart sounds great, HappyDoc writes your normal value. If you mention a Grade 2 murmur, it writes "Grade 2 heart murmur."
Click Save.
⚠️ Yellow warning icon? It shows when a field outside the Objective section is set to "if abnormal, otherwise use normal value". HappyDoc would then only write what you said if it decides it was abnormal, which usually isn't what you want in history or plan fields.
Step 5: Choose what to write when something isn't discussed
Open If Not Discussed on the field.
Default behavior writes "-" when the topic didn't come up.
Hide field from output leaves the whole field out of the note when it wasn't discussed.
Use a specified value lets you type exactly what to write instead, such as "Not mentioned".
Click Save.
Step 6: Add instructions to one field
Open the field's Advanced Settings.
Type your instruction in Custom Instructions, for example "Always display weight in both lbs and kg."
Click Save, then generate the document on a recent visit to check the result. Preview shows layout only, not the effect of instructions.
Field instructions apply only to their own field. Instructions on a section don't carry down to the fields inside it, and the whole document's Custom instructions (Step 1) are the place for anything that should apply everywhere.
Troubleshooting / FAQs
Q: Can HappyDoc write our notes in Spanish (or another language)?
A: Yes. In the builder, open Advanced Settings under the name boxes and choose an Output language, then click Save.
Q: Why does a field just show "-"?
A: That topic wasn't picked up in the recording. Set If Not Discussed to Hide field from output or Use a specified value if you'd rather see nothing or your own wording.
Q: My normal value shows even though I mentioned a problem.
A: Check the transcript to make sure the problem was captured (clip three dots, View Transcript). If it was, add a Custom Instructions line to that field describing what counts as abnormal for you.
Q: Can I change a field to bullet points or a paragraph?
A: There's no format setting any more. HappyDoc lays out each field for you, and list fields always come out as bullet points.
Q: I don't see Custom Instructions on a field.
A: Message us in the app and we'll check it's switched on for your practice.
Q: I've tried all of this and the output still isn't right.
A: You might need a field of your own. See Custom Fields in Your Documents 🏷️, or message us and we'll help you decide.
💬 Need a hand? Chat with us in the app (bottom right corner) or email [email protected]. We're always happy to help.
Related Articles









