Skip to content
English
  • There are no suggestions because the search field is empty.

How to Create and Manage Questionnaires

A step-by-step guide on how to upload CSV-formatted question sets, defines answer scoring methods, and configure compliance framework mappings for third-party security assessments

Questionnaires are the question sets you send to entities to assess their security. There are two types: Entity questionnaires, which produce a maturity score, can map to frameworks such as NIST and the Master Control Framework, and can link to your Issues and Capabilities Assessment; and Standard questionnaires, which are a simple form with no scoring. You build a questionnaire as a CSV and upload it. This article covers creating, uploading, and maintaining them.

Building the questionnaire CSV

You can download the template for the questionnaire from the 'Upload Questionnaire' option next to the 'Manage Questionnaires' page header. The menu it opens will have a 'Download standard questionnaire template' option you can use to get the template.

A questionnaire is defined in a CSV, where each row is a question. The key columns are:

  • Index: a unique ID for each question, used to reference it.
  • Section1 and Section2: the category (mandatory) and optional subcategory the question sits under.
  • Question and Answers: the question text and its answer options (Answer1, Answer2, and so on).
  • Question Type: single choice, multiple choice, or comment, with a Scoring Type of Sum or Max for multiple-choice questions.
  • Comment and Attachment requirements: whether a comment or attachment is required, and any dependencies that show a question only when a prior answer is given.
  • Entity-only columns: Answer Points, NIST Mapping, and MCF Mapping, which drive the maturity score and framework mapping. Standard questionnaires omit these.

Most upload errors come from a missing or duplicated Index, or from circular dependencies between questions. Check these first if an upload is rejected.

Uploading a questionnaire

  1. Navigate to Assessments > Questionnaires and click the Upload Questionnaire icon beside the Manage Questionnaires heading. The book icon opens the full formatting instructions.
  2. Enter a Name, select the Type (Entity), choose your .csv file, and click Upload.
  3. After the upload, give your workspace a minute to process the questionnaire and any attached mappings, and then refresh your page. The questionnaire should now be listed alongside your existing questionnaires in the 'Open' section.

Managing your questionnaires

Assessments > Questionnaires, headed Manage Questionnaires, lists your questionnaires on three tabs, Open, Closed and Archived. For each one it shows the name, display name, type, number of questions, number of submitted responses and creation date. Each row has four actions:

  • Preview Questionnaire (eye icon) opens the questionnaire in a new browser tab as a respondent sees it. The respondent details fields are disabled in preview. Each section of questions is listed with how many of its questions are answered, for example Hardware 0/5, which respondents use to track their progress.
  • View Results opens the questionnaire's results page (below).
  • Download Results downloads the responses received.
  • Settings (gear icon) opens the questionnaire's settings (below).

Viewing results

The results page shows the questionnaire's name and status, how many responses have been submitted (for example Submitted 3 / 5 (60%)), and its Start Date, Closed Date and Duration. The Respondent View table has a row for each respondent, with their answer to every question, their name and company or department, their Cyber Maturity Score and Assessment Score, the response's status and when it was last updated. The Cyber Maturity Score measures the answers against a framework's maturity scale; the Assessment Score is the points the respondent scored as a percentage of the points available.

Use the Assessment Score and Cyber Maturity Score switches to show or hide those two columns, and click View Results in a row to open that respondent's saved answers. Click < Go Back to return to the list.

Changing a questionnaire's settings

Click the gear icon in a questionnaire's row to open its settings. Here you can:

  • Change the Questionnaire Display Name, which is the name respondents see. The questionnaire's own Name and its Type cannot be changed after upload.
  • Change its Status to Open, Closed or Archived (see Questionnaire status below).
  • Upload a Logo to show respondents, as a JPEG or PNG file of up to 20 MB.
  • Click Download original csv file to get a copy of the CSV you uploaded.

Click Save to apply your changes, or Close to leave without saving.

Questionnaire status

Every questionnaire is Open, Closed or Archived. Only an Open questionnaire accepts answers: if you close one while an entity is partway through, their saved work is kept but they cannot add to it. Close a questionnaire when you want to stop new responses without losing the ones you have, and archive it when it is no longer part of your programme.

To change a questionnaire's status, click the gear icon in its row, choose the new Status and click Save. The questionnaire moves to the matching tab.

Scoring an assessment automatically

A questionnaire can carry acceptance and rejection thresholds, expressed as a percentage of the available points. Where every questionnaire on a self-assessment has them set, CyberHQ scores the submission against those thresholds and records the outcome without a reviewer.

This suits high-volume, low-risk assessments where a human review adds little. It is worth being deliberate about it, because an assessment decided this way is accepted or rejected with no one having read the answers. Leave thresholds unset on anything where the findings matter.

[VERIFY: where the thresholds are configured, and confirm auto-decision applies only to self-assessments rather than all entity assessments.]