Initialization Option Items API

shuffle_items

Randomizes the order of Items in the assessment.

You would want to specify this option so that you can have the presentation order of Items be different from the sequence set in the authored Activity.

A seed value can be specified to create a random but repeatable order of Items. The default seed uses the session_id value. This means that every learner will see a different order of shuffling, because they each have a unique session ID.

Examples

// Randomize Items in the assessment based on the session_id
var initializationOptions = {
    "config": {
        "configuration": {
            "shuffle_items": true
        }
    }
};

// Randomize Items based on the year as a seed. All learners will see the same order of Items for the specified seed.
// If you change the seed to 2024, a new order of Items will be used.
var initializationOptions = {
    "config": {
        "configuration": {
            "shuffle_items": "2023"
        }
    }
};

Values

Request object key config.configuration.shuffle_items

Default: false

This option can be initialized as one of the following types: boolean string.

  • Type boolean

    When true, randomizes Items using the session_id as the seed. This results in a different order per session, giving each learner a different sequence.

  • Type string

    Randomizes Items using the supplied value as the seed. This results in the same sequence for all learners taking this assessment with the specified seed value.

Related articles

Was this article helpful?