Skip to main content

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:
ColumnDescription
Template NameThe name of the template
Client GroupThe client group the template belongs to
DetailsCombined count of sections and questions
CustomisationsNumber of customisations applied
Pricing (incl. GST)The price associated with this template
Last ModifiedWhen the template was last updated
ActiveToggle to enable or disable the template
ActionsEdit, copy, or delete the template
The template list displays only active templates. Deleted templates are removed from the active list.
The Active column shows a toggle that lets admins enable or disable templates. Disabled templates are not available for new evaluations.

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:
SettingDescription
Template NameThe name displayed to contractors and administrators
DescriptionOptional description of the template’s purpose
ClientThe client group this template belongs to (cannot be changed after creation)
Passing PercentageThe minimum score percentage (0-100) required for evaluation approval
Show Score on Certificate and Approval EmailWhether the evaluation score appears on the certificate PDF and in the approval email sent to contractors
Validity PeriodHow many months an approved evaluation remains valid (1-60 months)
Enable Conclusion FieldWhether the evaluation includes a conclusion field for the assessor
Require ConclusionWhen 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
This allows you to control whether contractors and third parties viewing the certificate or approval email see the numerical score, while ensuring the full report always contains complete assessment details. To configure:
  1. Open the template
  2. Locate the Show Score on Certificate and Approval Email checkbox below the passing percentage field
  3. Toggle on or off as required
  4. 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:
SettingDescription
PriceThe fee charged for evaluations using this template. Set to $0 to make the accreditation free.
Score Review EnabledWhether a score-based review step is available for this template
Review NameThe label shown to contractors for the review option
Review PriceThe additional charge for the score review step. Must be greater than $0 when score review is enabled.
A standard price of 0createsafreeaccreditationcontractorsgothroughanochargeconfirmationflowwithnobillingaddressorStriperedirect.Ifscorereviewisenabled,thereviewpricemustbegreaterthan0 creates a free accreditation — contractors go through a no-charge confirmation flow with no billing address or Stripe redirect. If score review is enabled, the review price must be greater than 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.
Each requirement specifies:
FieldDescription
Insurance TypeThe type of insurance (e.g. Public Liability, Professional Indemnity) selected from the system-wide insurance types list
Minimum CoverageThe minimum coverage amount required (in NZD)
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.
Changes to insurance requirements on a template do not affect evaluations already in progress. They apply to new evaluations and to the insurance visibility for active certifications linked to this template.

Editing Templates

Modifying Content

  1. Open the template
  2. Make changes to sections or questions
  3. Save changes
  4. Changes apply to new evaluations only
Editing active templates doesn’t affect evaluations already in progress.

Managing Sections

Adding a Section

  1. Click Add Section
  2. Enter section name
  3. Add description (optional)
The new section is appended to the end of the template. Reorder sections using drag and drop after adding.

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.
ColumnDescription
(Checkbox)Select questions for bulk actions
Internal NameThe internal label for the question
ClientThe client the question belongs to
NumberQuestion reference number
QuestionThe question text shown to contractors
ConfigurationBadges showing type, scoring settings, and other configuration
UsageTemplates that use this question
ActionsEdit or delete the question

Creating Questions

  1. Click Create Question
  2. Enter question text
  3. Select question type
  4. Configure options (for select types)
  5. Add help text (optional)
  6. Save

Question Types

TypeUse Case
TextShort free-form responses
Text AreaLonger free-form responses
Yes/NoBinary questions
SelectSelect one option from a list
Multi SelectSelect multiple options from a list
FileDocument submission
DateDate selection
NumberNumeric input

Editing Questions

  1. Find the question
  2. Click to edit
  3. Modify as needed
  4. Save changes
Editing a question updates it everywhere it’s used.

Adding Questions to Templates

From Question Bank

  1. Open template
  2. Navigate to target section
  3. Click Add Question
  4. Search/browse question bank
  5. Select question(s)
  6. Add to section

Question Settings

Each question in a template has per-template settings that control how it behaves within that template:
SettingDescription
RequiredMust be answered to submit
OptionalCan be skipped
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:
SettingDescription
Help TextGuidance for contractors, set on the question in the Question Bank
Hidden from ReportExcludes 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.
To enable:
  1. Open the template and navigate to the question
  2. Open the question settings
  3. Toggle Hidden from Report on
  4. 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

  1. Open the template
  2. Navigate to the Directives tab
  3. Toggle Enable Directives & Expectations on
  4. Enter a title for the directives section (e.g. “Health & Safety Commitments”)
  5. Compose your directive content in the HTML editor
  6. Attach any supporting files or links (optional)
  7. 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
Use clear, specific language. If your directives cover multiple obligations, use numbered lists or headings to make each one distinct and easy to review.
You can attach up to 20 assets to a template’s directives. Each asset is either a file or an external link:
Asset typeDescription
FileA downloadable document (e.g. PDF policy, compliance checklist) selected from your customer files.
LinkAn external URL (e.g. link to legislation, an online policy portal).
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.
  1. If you haven’t already, navigate to Settings and select the Files tab, then upload the document
  2. Return to the template’s Directives tab
  3. Use the Add from customer files dropdown to select the file — only files not already attached are shown
  4. The file is added with an auto-generated label based on the filename. You can change the label if needed.
  5. Save
The Add from customer files dropdown only shows files uploaded via Settings > Files. If the file you need isn’t listed, upload it there first.
  1. In the Directives tab, enter the URL (must start with http:// or https://)
  2. Enter a descriptive label
  3. Click Add Link
  4. Save
Contractors see all attached assets alongside the directive content and can download files or follow links before accepting.

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 caseExample
Health & safety commitmentsAttach your H&S policy PDF and require contractors to acknowledge compliance
Compliance obligationsLink to relevant legislation and require confirmation of understanding
Terms of serviceInclude full terms in the HTML editor with a link to the latest version online
Site-specific requirementsAttach 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:
  1. Navigate to Templates
  2. Find the template you want to delete
  3. Click the delete action
  4. Confirm the deletion
Templates that are currently assigned as live templates to categories cannot be deleted. You must first unlink the template from all categories before deletion. The system will display an error message if the template is still in use.
When a template is deleted, it is removed from the active template list. Evaluations already in progress using that template are not affected.

Best Practices

Write clear, unambiguous questions. Include help text for complex topics.
  • Use consistent terminology
  • Group related questions
  • Test templates before use
  • Review templates periodically

Next Steps

Company Management

Learn about managing contractor companies