Before you start
This article is for anyone who wants to build or change a note template in HappyDoc. Document Builder is in the web app at app.gohappydoc.com, so use a computer (Chrome works best). Templates can't be built in the phone apps.
Want the finer controls (show or hide a field, normal values, output language)? See Document Builder: Advanced Settings 🗝️ once you've got the basics.
Already have a paper form or PDF you like? Scout can turn it into a template for you. See Custom Documents: Build One From a PDF 📄.
Step 2: Name it and save
In the first box at the top (Name your SOAP Record), type a name your team will recognize, such as "Wellness SOAP".
In the box next to it, type a short Document Description so everyone knows when to use it.
Click Save at the top right. Your edits are not saved automatically, so click Save often as you build.
Step 3: Add sections and fields
Find the field you want in the Fields panel on the right. Type in Search All Fields, or use the All Fields dropdown to filter by category.
Hover over the i icon next to a field to read what it captures. This helps you pick between similar fields.
To add a new section, drag a field onto an ADD A SECTION line between two sections (or onto the box at the bottom of the page).
To add a field inside a section, click the section to open it, then drag the field into it.
To move a section or field, drag it by the four arrow handle on its left.
Step 4: Adjust each field
Click into a field's title box to rename it. This is the label that appears in your note.
For exam fields, type your usual wording in Normal Value, for example "Healthy coat and skin". HappyDoc uses it when that area is normal.
To remove a field or section, click the X on its right, or drag it back into the Fields panel.
Click Save.
There's no format menu to set on each field: HappyDoc lays each field out for you, and list fields always come out as bullet points.
Step 5: Choose how it looks when exported
Click Export Settings at the top right of the builder.
Pick a font under Choose a Font.
Pick a layout: Indented Fields (the default, like the HappyDoc print layout) or Center-aligned Objective Section. The preview on the right updates as you choose.
Under Record Color, choose Use account default, Never color this document type or Custom color. This is the color the note shows in your practice system's records, if your system uses colors.
Save your choices in the window, then click Save at the top of the builder.
Step 6: Preview, save and switch it on
Click Preview at the top center to see the layout. Preview shows formatting only; it doesn't apply any custom instructions.
Click Build to go back and keep editing.
Click Save.
Click Back to Previous Page. In the Documents list, switch on the Active toggle next to your new document.
Try it on a visit: under Generate Documents, pick it in Select documents and click Generate.
Step 7: Edit or copy a document later
Open Settings, then Documents.
Click the three dots on the right of the document.
For your own documents, choose Edit Document. The same menu has Copy Document and Delete Document.
Built in documents (marked Default, like HappySOAP) only have Preview Document and Copy Document. Choose Copy Document, then edit the copy.
Want to keep the current version safe while you experiment? Copy it first and edit the copy.
Click Save when you finish.
Save often: nothing in the builder saves until you click Save.
Start from HappySOAP: it's quicker to remove what you don't need than to build from blank.
Test on a real visit: generate your new document on a recent visit and compare it with HappySOAP before rolling it out. |
Troubleshooting / FAQs
Q: I made changes to my template and they disappeared.
A: The builder doesn't save on its own. Make your changes again and click Save at the top right before you leave the page.
Q: Can I edit HappySOAP directly?
A: No. Built in documents can only be previewed or copied. Open Settings, then Documents, click the three dots next to HappySOAP, choose Copy Document and edit the copy.
Q: I built a document but I can't pick it on my visit.
A: It's probably switched off. Open Settings, then Documents, and switch on the Active toggle next to it.
Q: Can HappyDoc write my note in another language?
A: Yes. Open Advanced Settings at the top of the builder and choose an Output language. See Document Builder: Advanced Settings 🗝️.
Q: Can someone build the template for us?
A: Yes. Our customer success team can help: email Liz at [email protected] with an example of the note you want.
💬 Need a hand? Chat with us in the app (bottom right corner) or email [email protected]. We're always happy to help.
Related Articles









