Account Admins customize inspection templates in Manage by editing sections and items, rating types, Custom Scores, and required photo or note capture.
Use it to make sure your templates collect clean, actionable information that aligns with final account statements.
In this article
- Before you start
- Opening the template editor in Manage
- Searching for sections and items in the new template editor
- What the template search shows
- Adding a new section
- Renaming sections or items
- Adding items
- Creating a new rating set while adding an item
- Rating icons and legacy icons
- Setting a Custom Score with a predefined value
- Setting a Custom Score for manual entry
- Making an item required
- Requiring a photo on a required item
- Requiring a photo without making the item required
- Troubleshooting: error when deleting a template
- Frequently asked questions
HappyCo can build templates for you
If you prefer not to create or edit templates yourself, the HappyCo support team can build them for you for an additional cost. Email HappyCo Support at support@happy.co for more information.
Before you start
- Permissions: Account Admin permissions are required to access, add, edit, configure, and delete templates in Manage.
- Sharing: when adding new templates, assign the proper Report Workflows and Property Sharing so properties have access to the new template.
| Concept | What it does |
|---|---|
| Checkboxes (circular checkboxes) | Inspectors can select multiple ratings at once for a single item, for instance both Good and Clean for a bed. |
| Radio buttons / radio groups | Restrict selection to a single option within a set, for instance a Yes or No choice. |
| Drop-down lists / pop-up menus | Appear as a rectangle on the left-hand side of the app. Tapping one opens a menu where the inspector selects only the single most appropriate option. |
| Custom Scores | Inspectors enter predefined or custom numeric values, such as cost estimates, directly in the field during an inspection. |
| Required fields | Mandate data capture (ratings, photos or notes) for high-priority items. The inspection cannot be completed until these items are verified. Use them on critical walkthrough items to protect against undocumented damages. |
Which template editor do you have?
If the item panel shows Edit options, you are in the new template editor. If you see Edit Rating Sets, you are in the older editor.
Opening the template editor in Manage
-
Go to Settings, then Templates
In Manage, navigate to Settings > Templates. -
Open the template
Click the template you want to edit to open its preview. -
Click Edit Template
Click Edit Template (or Edit) in the top right corner.Tip
If you change a template after inspections have been completed with it, those previous inspections stay the same.
Searching for sections and items in the new template editor
Click the search box in the editor header
Click the Search sections and items box in the header, next to the template name, with Save & Exit beside it.
Tip
The search box appears only while you are editing a template, not in Fill preview.
Type part of a section or item name
The template filters in place. It does not open a list of results.
Tip
Search is not case-sensitive.
Click a matching item to edit it
The item opens as usual.
Clear the search
Clear the search box to see the full template again.
What the template search shows
- Section name matches: that section shows with all its items.
- Otherwise: only matching items show, inside their sections.
- Sections with no match are hidden.
- Matching sections open automatically.
- Overview and Summary are searched by their headings and field labels.
- No match: a message says so.
Some controls are off while a search term is entered
You can still edit, delete and select items. You can't drag items, move or duplicate sections, or add sections or items. Clear the search to turn those controls back on.
Adding a new section
-
Click Add Section
Click Add Section. -
Enter the section name
Enter the Section Name. -
Optional: copy another section's items
To copy another section's items, select that section so a checkmark appears next to it. -
Click Create Section
Click Create Section.
Renaming sections or items
-
Click the section or item name
Click the section or item name on the right side of the screen.Tip
To edit the Info section, click the (i) circle and edit the information on the right side.
-
Enter the new name
Enter the new name in the Name field. -
Click Update
Click Update to commit your changes.
Adding items
-
Click Add Item
Click Add Item (or Add new item at the bottom of the section). -
Enter the item name
Enter the Item Name. -
Optional: add notes and comments
Enter instructions for inspectors in the Notes field and pre-filled comments in the Comments field. -
Select a rating set
Click Select Another Rating Set and choose a rating set. -
Click Create Items
Click Create Items.
Rating set is now called Options
In the new editor, the old Rating set section is named Options. The preset picker moved out of the Edit options window and into the item drawer.
Items with several ratings keep only one
Each item has one answer type. If you edit an older item that has several ratings, only the primary one is kept. The drawer warns you about this first.
Creating a new rating set while adding an item
-
Click the + icon in the Rating section
When creating a new item, click the + (plus) icon in the Rating section. -
Enter the Label
The Label is the identifier shown in the inspection and report. -
Enter the Short Hand
The Short Hand is the abbreviation displayed in the mobile app. -
Enter the Grade
The Grade is the selection represented on the final report, for instance Yes or No. -
Choose a color and icon
Choose a color and an icon for the rating. -
Click the checkmark to save
Click the checkmark.
Rating icons and legacy icons
In both editors you pick icons one rating at a time. There is no option to choose a whole icon set at once.
- New editor: in Edit options, click the icon next to a rating to choose a symbol and color.
- A preset in Option set fills in labels, colors and icons for every option at once.
- After applying a preset, change each icon individually.
- Legacy icons show on existing items, on the field card and in Edit options.
- The new editor can display every legacy icon.
- Legacy colors show as the nearest of the new editor's 5 colors.
- The Edit options icon picker offers 11 icons and 5 colors, so most legacy icons can't be chosen there.
- Older editor: click Edit Rating Sets, open the rating set, then click a rating.
- Older editor: under Custom Symbol, choose an icon from the tabs for each grade.
- Selector ratings have no icon choice, only a color.
Setting a Custom Score with a predefined value
-
Click the item
Click the item you want to configure in the template editor. -
Check Custom Score
Check the Custom Score checkbox. -
Enter a preset value
Enter a preset numerical value in the Score field. -
Click Update Item
Click Update Item at the bottom of the panel. -
Click Save & Exit
Click Save & Exit in the top right.
Setting a Custom Score for manual entry
-
Click the item
Click the item you want to configure. -
Check Custom Score and leave Score empty
Check the Custom Score checkbox and leave the Score field empty. -
Click Update Item
Click Update Item. -
Click Save & Exit
Click Save & Exit.
Making an item required
-
Click the item
Click the item in the template editor. -
Check Required
In the Edit Item panel on the right, check the Required checkbox. -
Click Update Item
Click Update Item. -
Click Save & Exit
Click Save & Exit.
Photo requirements need a checkbox-style rating
Photo requirements are only possible on checkbox-style ratings.
Requiring a photo on a required item
-
Click the item and confirm Required is checked
Click the item and check that the Required checkbox is checked. -
Click the + icon under Rating Set
Under the Rating Set section, click the + (plus) icon. -
Select a checkbox button-style rating
Select a checkbox button-style rating. -
Check Require Photo
Check the Require Photo checkbox. -
Click Update Item
Click Update Item. -
Click Save & Exit
Click Save & Exit.
Requiring a photo without making the item required
-
Click the item and leave Required unchecked
Click the item in the template editor and leave the Required checkbox unchecked.Tip
Use this when you only need a photo in certain situations, without forcing the inspector to rate or check off the item.
-
Click the + icon under Rating Set
Under the Rating Set section, click the + (plus) icon. -
Select a checkbox button-style rating
Select a checkbox button-style rating. -
Check Require Photo
Check the Require Photo checkbox. -
Click Update Item
Click Update Item. -
Click Save & Exit
Click Save & Exit.
Troubleshooting: error when deleting a template
- Problem: you receive an error when trying to remove a template.
- Cause: the template is likely part of an active Inspection Schedule.
- Resolution: disable all Inspection Schedules using the template, then delete it.
Frequently asked questions
Can HappyCo create or edit templates for me?
Yes. If you prefer not to create or edit your own templates, the HappyCo team can build them for you for an additional cost. Email HappyCo Support at support@happy.co for more information.
What is the difference between checkboxes and radio buttons in ratings?
Checkboxes let you select multiple answers if they all apply to a single item, for instance an item that is both Good and Clean. Radio buttons restrict inspectors to selecting only one option from the set, for instance a simple Yes or No.
Can I require a photo for an item without making the item's rating mandatory?
Yes. In the template editor, select a checkbox-style rating for that item and check Require Photo, while leaving the main Required box empty.
Does the Type menu replace choosing a rating set?
No, you do both in one drawer. Type comes first. For a Rating type, you still pick a preset from a dropdown in the drawer.
Can I pick a whole legacy icon set at once?
No. In both editors you pick icons one rating at a time.
Why can't I drag items or add sections while searching?
Those controls are off while a search term is in the box. Clear the search to turn them back on.