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:| Column | Description |
|---|---|
| Template Name | The name of the template |
| Client Group | The client group the template belongs to |
| Details | Combined count of sections and questions |
| Customisations | Number of customisations applied |
| Pricing (incl. GST) | The price associated with this template |
| Last Modified | When the template was last updated |
| Active | Toggle to enable or disable the template |
| Actions | Edit, copy, or delete the template |
The template list displays only active templates. Deleted templates are removed from the active list.
Creating a Template
Template Configuration
Basic Settings
When creating or editing a template, you can configure:| Setting | Description |
|---|---|
| Template Name | The name displayed to contractors and administrators |
| Description | Optional description of the template’s purpose |
| Client | The client group this template belongs to (cannot be changed after creation) |
| Passing Percentage | The minimum score percentage (0-100) required for evaluation approval |
| Show Score on Certificate and Approval Email | Whether the evaluation score appears on the certificate PDF and in the approval email sent to contractors |
| Validity Period | How many months an approved evaluation remains valid (1-60 months) |
| Enable Conclusion Field | Whether the evaluation includes a conclusion field for the assessor |
| Require Conclusion | When enabled, assessors must complete the conclusion field before approving |
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:| Setting | Description |
|---|---|
| Price | The fee charged for evaluations using this template. Set to $0 to make the accreditation free. |
| Score Review Enabled | Whether a score-based review step is available for this template |
| Review Name | The label shown to contractors for the review option |
| Review Price | The additional charge for the score review step. Must be greater than $0 when score review is enabled. |
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
Scroll to Insurance Requirements
The Insurance Requirements card appears below the template’s sections and questions.
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.
| Field | Description |
|---|---|
| Insurance Type | The type of insurance (e.g. Public Liability, Professional Indemnity) selected from the system-wide insurance types list |
| Minimum Coverage | The minimum coverage amount required (in NZD) |
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.| Column | Description |
|---|---|
| (Checkbox) | Select questions for bulk actions |
| Internal Name | The internal label for the question |
| Client | The client the question belongs to |
| Number | Question reference number |
| Question | The question text shown to contractors |
| Configuration | Badges showing type, scoring settings, and other configuration |
| Usage | Templates that use this question |
| Actions | Edit or delete the question |
Creating Questions
- Click Create Question
- Enter question text
- Select question type
- Configure options (for select types)
- Add help text (optional)
- Save
Question Types
| Type | Use Case |
|---|---|
| Text | Short free-form responses |
| Text Area | Longer free-form responses |
| Yes/No | Binary questions |
| Select | Select one option from a list |
| Multi Select | Select multiple options from a list |
| File | Document submission |
| Date | Date selection |
| Number | Numeric input |
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:| Setting | Description |
|---|---|
| Required | Must be answered to submit |
| Optional | Can be skipped |
| Setting | Description |
|---|---|
| Help Text | Guidance for contractors, set on the question in the Question Bank |
| Hidden from Report | Excludes the question and its answer from the generated report, set on the question in the Question Bank |
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:| Asset type | Description |
|---|---|
| File | A downloadable document (e.g. PDF policy, compliance checklist) selected from your customer files. |
| Link | An external URL (e.g. link to legislation, an online policy portal). |
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
| Use case | Example |
|---|---|
| Health & safety commitments | Attach your H&S policy PDF and require contractors to acknowledge compliance |
| Compliance obligations | Link to relevant legislation and require confirmation of understanding |
| Terms of service | Include full terms in the HTML editor with a link to the latest version online |
| Site-specific requirements | Attach site induction documents that contractors must review before submitting |
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