The scaledMatrix function formats a likert matrix question in variety of ways. A scaled matrix is similar to an NPS question where the scale is anchored on the ends and the choices are numbered. Like an NPS question, the scaled matrix format works well on both desktop and smartphones. The function should only be used with “Classic” layout.

Functionality includes:

• Option for formatting single row matrix questions
• Option for formatting for last column 'NA', 'Not sure' etc. including width and format of divider
• Options for repeating headers in middle or on bottom
• Supports scale images
• Supports middle labels, not just end labels (unlike NPS question)
• Optionally control width of scale labels
• Optionally add and format scale dividers
• Compatible with matrixHighlightUnanswered

Desktop Examples

Mobile Examples (same questions as above)

This function is available for a reasonable fee. Contact TomG on the Qualtrics Community to learn more.

To make the function available to all questions in the survey, copy the function to the Survey Header inside a script tag: Add the scaledMatrix function to the survey header to make it available to any question in the survey. Go to Look & Feel → General → Header edit → and paste the provided scaledMatrix function JS:

<script>/*Paste scaledMatrix function JS here*/</script>

Alternatively, paste the scaledMatrix function JS into a question's JS outside the existing Qualtrics functions to make it available to questions on the page.

Set the following single choice Likert Matrix options:

• Uncheck Mobile Friendly
• Check Position Text Above

Add JS to call the scaledMatrix function to apply it to the Likert Matrix question as follows:

Qualtrics.SurveyEngine.addOnload(function() {
	scaledMatrix(this);
});

To override the default options, specify the desired options in the second function argument as an object. For example:

Qualtrics.SurveyEngine.addOnload(function() {
	scaledMatrix(this,{lastNA:true,scaleLabels:["Extremely<br>dissatisfied","Extremely<br>satisfied"]});
});

labelsBottom specifies whether scale labels should be repeated on the bottom. Set to true to turn on bottom labels.

Default: false

labelsBottomMin specifies the minimum number of rows before bottom scale labels will be displayed when labelsBottom is true.

Default: 3

labelsMiddle specifies how often middle repeat scale labels should be shown in number of rows. Setting to 0 (zero) turns middle labels off.

Default: 0

labelsTopHide specifies whether top scale labels should be hidden. Set to true to hide top scale labels.

Default: false

lastNA specifies the last column as 'NA', 'Not sure' etc. when set to true. Turning on automatically adjusts the position of the right scale anchor.

Default: false

NAdividerStyle specifies the CSS style of the NA divider that separate the NA answer from the other answers when lastNA is true.

Default: : “1px solid #666666”

NAwidth is used to override the default width of NA column to make it a different width that the other columns when lastNA is true. Specified as a percentage. Set to 0 (zero) to use default width.

Default: 0

oneChoiceSuppress is used to suppress the row label display when the matrix has only one row. Set to true to suppress display of the row label.

Default: false

scaleDividers is an array the specifies where dividers should be added to the scale. Specify the column number that dividers should be placed after.

Default: [] (no dividers)

scaleDividerStyle specifies the CSS style of the scale dividers when scaleDividers is specified.

Default: “1px solid #666666”

scaleImage specifies the url of the image that will be displayed above the scale.

Default: “” (none)

scaleLabels is an array that specifies the scale labels.

Default: [“Extremely<br>Unlikely”,“Extremely<br>Likely”]

scaleLabelsWidths is an array that specifies the width of the scale labels. For example: [“30%”,“40%”,“30%”]. If provided it must match the number of scaleLabels. Setting to [] (blank) auto-calculates the widths.

Default: [] (blank)