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:
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.

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:
  1. Navigate to Templates
  2. Find the template you want to export
  3. Click the Export CSV icon (download icon) in the Actions column
  4. The file downloads automatically once the export is ready
The export is disabled while another export is already in progress. All other export buttons are also disabled until the current export completes.

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
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:
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: 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.

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

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: 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.
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: 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

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