Before you start
This article is for anyone building a custom document who needs a field HappyDoc doesn't already have. You'll need a computer and a custom document to add it to (see Document Builder: Create a Custom Note 🛠️).
Try these first. HappyDoc has hundreds of fields. Search for yours in the Fields panel, and try adding Custom Instructions to an existing field (see Document Builder: Advanced Settings 🗝️). Both are quicker than building a field from scratch.
Look for Create Custom. If you don't see a Create Custom button at the top of the Fields panel, message us in the app and we'll check it's switched on for your practice.
Step 1: Open your document in the builder
Click the Account menu at the top right and choose Settings.
Click Documents.
Click the three dots next to your custom document and choose Edit Document.
Step 2: Open the Create Custom Field window
Look at the Fields panel on the right of the builder.
Click Create Custom at the top right of that panel. (This is a different button from Create Custom on the Documents page, which makes a whole new document.)
The Create Custom Field window opens.
Step 3: Fill in the field
Field Name: the label that appears in your note, for example "Activity Level".
Description: a short note for your team. It shows when someone hovers over the field's info icon.
Instructions: tell HappyDoc what to write in this field. This matters most; see the tips below.
Example Output: a real example of what a good answer looks like.
If Discussed: choose Display discussed value always, or the abnormal option if you want a Normal Value (a box appears for it). If you also see Format, leave it as it is.
Step 4: Create it
Check your example. Here's one for Activity Level: Instructions "Describe the pet's daily activity level and any recent changes, including but not limited to exercise routines and play habits."
Click Create Custom Field at the bottom right.
Your field now appears in the Fields panel, in alphabetical order. To see only your own fields, choose Custom Fields in the All Fields dropdown.
Step 5: Add it to your document
Drag your new field from the Fields panel into a section, just like any other field.
Click Save at the top right of the builder.
Make sure the document is switched on (Active) in Settings, then Documents.
Step 6: Test it and fine tune
Open a recent visit that covered this topic and generate your document.
Read what the field wrote. If it missed something or added too much, go back to the Fields panel.
Click Edit next to your field, change the Instructions, and save.
Generate again on a few visits before you change it again. One visit is too small a sample.
To remove a field you no longer need, click the trash icon next to it.
Be specific: "Describe the pet's daily activity" can miss recent changes. Say what matters, such as "and any recent changes".
But not too specific: a long list ("walks, hikes, dog parks") can make HappyDoc skip anything not on it, like daycare or agility.
Use "including but not limited to": it tells HappyDoc your list is examples, not the only things to capture.
Say what to leave out: if the field keeps picking up details that belong elsewhere, add "Don't include ..." to the instructions.
Give it a day: run new instructions for at least a day of visits before you tweak them again. |
Troubleshooting / FAQs
Q: I don't see Create Custom in the Fields panel.
A: Custom fields may not be switched on for your practice. Message us in the app and we'll check.
Q: My custom field comes out as "-" or empty.
A: HappyDoc didn't find that topic in the recording. Check the transcript (clip three dots, View Transcript). If the topic is there, make the Instructions clearer about what to look for. If it wasn't discussed, set If Not Discussed in the field's Advanced Settings to hide the field or write your own wording.
Q: How do I find my custom fields again?
A: Open the All Fields dropdown at the top of the Fields panel and choose Custom Fields, or type the name in Search All Fields.
Q: How do I change a custom field after I've made it?
A: Find it in the Fields panel, click Edit next to it, make your changes and save. Then click Save in the builder.
Q: Can someone help me write the instructions?
A: Yes. Our customer success team can help: email Liz at [email protected] with the field you want and an example of a good answer.
💬 Need a hand? Chat with us in the app (bottom right corner) or email [email protected]. We're always happy to help.
Related Articles




