Templates & Questions
Templates define what questions contractors and suppliers answer. This guide covers template and question management.Understanding Templates
A template contains:- Sections (groups of questions)
- Questions within each section
- Question ordering
- Required vs optional designations
Template List
Navigate to Templates to see all templates.Template Information
The template list shows the following columns:The template list displays only active templates. Deleted templates are removed from the active list.
Exporting a template to CSV
Administrators and assessors can export a template’s full structure to a CSV file for offline review. The export includes every question in the template along with its section, guidance, scoring configuration, attachment settings, and metadata. To export a template:- Navigate to Templates
- Find the template you want to export
- Click the Export CSV icon (download icon) in the Actions column
- The file downloads automatically once the export is ready
CSV columns
The exported file contains the following columns:
Sections are listed in their configured display order. Empty sections appear as a row with no question data. Questions not assigned to a section are grouped under Unsectioned at the end of the file.
The Export CSV action is available to administrators and assessors only. Viewers do not see this action.
Creating a Template
1
Start New Template
Click Create New Template and enter basic details.
2
Add Sections
Create sections to organise your questions.
3
Add Questions
Add questions from the question bank or create new ones.
4
Configure Settings
Set requirements, ordering, and visibility.
5
Activate
Review and activate the template for use.
Template Configuration
Basic Settings
When creating or editing a template, you can configure:Conclusion Settings
The Enable Conclusion Field and Require Conclusion settings control whether assessors see and must complete a conclusion field when reviewing evaluations on this template. When Enable Conclusion Field is on, assessors can enter a free-text conclusion as part of their review. Enabling Require Conclusion makes this field mandatory before an evaluation can be approved.Certificate and Approval Email Score Visibility
The Show Score on Certificate and Approval Email setting controls whether the overall evaluation score percentage appears on the certificate PDF and in the approval email sent to contractors.- When enabled, the score is displayed on both the certificate and the approval email
- When disabled, the score is hidden from both the certificate and the approval email
- The score is always shown on the Full Report regardless of this setting
- Open the template
- Locate the Show Score on Certificate and Approval Email checkbox below the passing percentage field
- Toggle on or off as required
- Save the template
The score shown on certificates and approval emails is calculated using the same logic as the full evaluation report, ensuring consistency across all generated PDFs and notifications. Changes to this setting only affect certificates and approval emails generated after the change — existing certificates and previously sent emails are not modified.
Pricing and Score Review Settings
The Pricing tab on a template allows configuration of:A standard price of 0 regardless of the standard price.
Insurance requirements
Each template can specify which insurance types contractors/suppliers must hold and the minimum coverage amount for each. These requirements drive insurance visibility and validation across the platform — see How insurance requirements work for the full lifecycle.Configuring insurance requirements
1
Open the template
Navigate to Templates and open the template you want to configure.
2
Scroll to Insurance Requirements
The Insurance Requirements card appears below the template’s sections and questions.
3
Add a requirement
Click Add Requirement. Select an insurance type from the dropdown and enter the minimum coverage amount (in NZD). Only insurance types not already added to this template are available.
4
Save the template
Save the template. The insurance requirements are stored and apply to all evaluations using this template.
You can edit or remove existing requirements using the edit and delete icons next to each row.
Insurance requirements are configured per template. When a company has evaluations under multiple templates, the system uses the highest minimum coverage amount if the same insurance type appears in more than one template.
Editing Templates
Modifying Content
- Open the template
- Make changes to sections or questions
- Save changes
- Changes apply to new evaluations only
Managing Sections
Adding a Section
- Click Add Section
- Enter section name
- Add description (optional)
Reordering Sections
Sections are reordered via drag and drop using the grip handle on each section row. Keyboard navigation is also supported — select a section and use ArrowUp / ArrowDown to move it. The new order is saved automatically.Question Bank
Viewing Questions
Navigate to Questions to see all questions.Creating Questions
- Click Create Question
- Enter question text
- Select question type
- Configure options (for select types)
- Add help text (optional)
- Save
Question Types
Editing Questions
- Find the question
- Click to edit
- Modify as needed
- Save changes
Editing a question updates it everywhere it’s used.
Adding Questions to Templates
From Question Bank
- Open template
- Navigate to target section
- Click Add Question
- Search/browse question bank
- Select question(s)
- Add to section
Question Settings
Each question in a template has per-template settings that control how it behaves within that template:
The following settings are configured on the question itself in the Question Bank and apply wherever the question is used — they are not per-template overrides:
Hidden-from-report questions
The Hidden from Report toggle prevents a question and its answer from appearing in the final evaluation report. This is useful when you need to collect information that should not be visible in the report shared with third parties. Common use cases:- Internal data collection — gather operational data from contractors that is only needed for internal analysis
- Sensitive information — collect data that is required for assessment but should not appear in external-facing reports
Enabling Hidden from Report automatically forces the question to non-scoring. Hidden questions do not contribute to the evaluation score.
- Open the template and navigate to the question
- Open the question settings
- Toggle Hidden from Report on
- Save
Template directives & expectations
Directives are formal expectations or commitments that you can attach to a template. When a template has directives enabled, contractors must review and accept them before they can submit an evaluation. This ensures that contractors acknowledge key obligations before proceeding.Enabling directives on a template
- Open the template
- Navigate to the Directives tab
- Toggle Enable Directives & Expectations on
- Enter a title for the directives section (e.g. “Health & Safety Commitments”)
- Compose your directive content in the HTML editor
- Attach any supporting files or links (optional)
- Save
Writing directive content
The directives content field is an HTML editor that supports rich formatting. You can:- Write formatted text with headings, lists, and tables
- Add hyperlinks inline using the editor’s link tool — useful for linking to external policies, legislation, or reference material
- Structure multiple obligations within a single directives section using headings or numbered lists
Attaching files and links
You can attach up to 20 assets to a template’s directives. Each asset is either a file or an external link:
Each asset requires a label — this is the display text contractors see (e.g. “Download H&S Policy PDF” or “View compliance guidelines”).
Attaching a file
Files must be uploaded to Settings > Files before they can be attached to directives.- If you haven’t already, navigate to Settings and select the Files tab, then upload the document
- Return to the template’s Directives tab
- Use the Add from customer files dropdown to select the file — only files not already attached are shown
- The file is added with an auto-generated label based on the filename. You can change the label if needed.
- Save
Attaching a link
- In the Directives tab, enter the URL (must start with
http://orhttps://) - Enter a descriptive label
- Click Add Link
- Save
How directives work
- Contractors see the full directives section (title, content, and assets) before the submission step
- Contractors must accept the directives as a whole before they can submit
- Acceptance is timestamped and the accepting user is recorded
- Assessors can view whether directives were accepted and when during their review
- The accept action is idempotent — if a contractor has already accepted, no change occurs
Use cases
Directives are configured per template. All evaluations using that template inherit the same directives. Changes to directives on a template do not affect evaluations already in progress.
Importing and exporting questions
Question import and export are available via the Admin API only. There is no import or export UI in the admin dashboard at this time.
Deleting Templates
To delete a template:- Navigate to Templates
- Find the template you want to delete
- Click the delete action
- Confirm the deletion
Best Practices
- Use consistent terminology
- Group related questions
- Test templates before use
- Review templates periodically
Next Steps
Company Management
Learn about managing contractor companies