Randomization

Please note that Surveys built-in randomization is not compatible with the advanced radomization codes for matrices provided in this tutorial. To enable them, import the library as described in the Getting started section.

Once you have completed the main steps, you will need to modify the parameters in the provided template snippet to apply the changes.

Variable
Example

question_code The code of the multiple choice matrix you want to configure.

multiple_choice_matrix({
    question_code: "Q3"
});

randomize Here we define settings for randomization. If not needed, just remove this entire block code and skip this tutorial 👍

multiple_choice_matrix({
    question_code: "Q3",
    randomize: {
    
    }
});

randomize -> rows Here we define the randomization for rows in the matrix. If not needed, just remove this entire block code.

multiple_choice_matrix({
    question_code: "Q3",
    randomize: {
        rows: {
            
        }
    }
});

randomize -> rows -> filter_schema This variable allows you to randomize rows in the same order as a previous question by using its schema. ℹ️ If you choose to use this feature, you can skip the rest of the configurations within rows' randomization.

multiple_choice_matrix({
    question_code: "Q3",
    randomize: {
        rows: {
            filter_schema: "Q0xSCHEMA"
        }
    }
});

randomize -> rows -> answer_groups This variable representes a list of row codes that you want to group together for randomization. The row codes should be wrapped inside bracket [] and separated by commas. ℹ️ Any remaining row codes that are not included in a group will be treat as anchors.

multiple_choice_matrix({
    question_code: "Q3",
    randomize: {
        rows: {
            answer_groups: [
                [1, 2]
            ]
        }
    }
});

randomize -> rows -> randomize_groups This variable determines whereter or not row groups should be randomized after elements inside them have been randomized. If set to true, both the elements within the groups and the groups themselves will be randomized. If set to false, only the elements within the groups will be randomized.

multiple_choice_matrix({
    question_code: "Q3",
    randomize: {
        rows: {
            answer_groups: [[1, 2]],
            randomize_groups: true
        }
    }
});

randomize -> columns Here we define setting for randomization in columns. If not needed, just remove this entire block code👍

multiple_choice_matrix({
    question_code: "Q3",
    randomize: {
        columns: {

        }
    }
});

randomize -> columns -> filter_schema This variable allows you to randomize rows in the same order as a previous question by using its schema. ℹ️ If you choose to use this feature, you can skip the rest of the configurations within columns' randomization

multiple_choice_matrix({
    question_code: "Q3",
    randomize: {
        columns: {
            filter_schema: "Q0xSCHEMA"
        }
    }
});

randomize -> columns -> answer_groups This variable representes a list of column codes that you want to group together for randomization. The column codes should be wrapped inside bracket [] and separated by commas. ℹ️ Any remaining column codes that are not included in a group will be treat as anchors.

multiple_choice_matrix({
    question_code: "Q3",
    randomize: {
        columns: {
            answer_groups: [[1, 2]]
        }
    }
});

randomize -> columns -> randomize_groups This variable determines whether or not column groups should be randomized after elements inside them have been randomized. If set to true, both the elements within the groups and the groups themselves will be randomized. If set to false, only the elements within the groups will be randomized.

multiple_choice_matrix({
    question_code: "Q3",
    randomize: {
        columns: {
            answer_groups: [[1, 2]],
            randomize_groups: true
        }
    }
});

PreviousMultiple choice matrix - ReferenceNextArray filter

Last updated

Was this helpful?