To enable users to retake an assessment, you must reset the assessment and republish the project. How you reset the assessment before republishing the project depends on the Assessment widget module version installed in the project:

If the project has Assessment widget module 1.0.0 installed, you must reset the assessment with a new data-uuid value.
If the project has Assessment widget module 2.0.7 or later installed, you can either reset the data-uuid to undo the lock or modify the assessment by adding or deleting questions.

If you remove the lock on an assessment and republish the project, any user can retake the assessment. This includes users who have already received a score. Use distribution rules to block specific users from retaking an assessment.

Check with your EchoInk Module Administrator for the Assessment widget module version installed for your projects.

Reset Assessment With New Data-Uuid Value

Valid for assessments built with Assessment widget module 1.0.0 and 2.0.0.

Each assessment has a unique identiﬁer, which is the data-uuid attribute value in the <object> tag. Inkling uses this data-uuid and the option speciﬁed in Retry Settings to determine if a user can retake a particular assessment.

Inkling permanently blocks a user from retaking a particular assessment when the following two conditions are met:

The Retry Settings option is set to either No Retries, Limited Retries, or Retry Until Pass.
A user exceeds the retry limit.

To remove the block and enable users to retake an assessment, you must reset the assessment with a new <object> data-uuid value in the HTML ﬁle, and sync the widget’s JSON conﬁg ﬁle name to this new data-uuid value.

Select the assessment widget in the Inkdoc.
This action highlights the corresponding HTML code in the code view editor.
Click Show Code View.
Locate the highlighted <object> tags for the assessment widget in the code view editor. These tags contain the data-uuid attribute.
Delete the alphanumeric value enclosed in quotation marks in the data-uuid attribute.
Do not delete the quotation marks.
Save and reload the page.
The data-uuid attribute displays with a new value.
We recommend keeping a record of the data-uuid values and publication dates for your assessment widgets so you can refer to them as needed.
Select the assessment widget in the Inkdoc.
Create and save a minor edit in the widget, such as adding an additional space after the title.
These actions reset the data-uuid value in the assessment widget’s config.json ﬁle to the new data-uuid value.
Verify that the object data-uuid value and the JSON ﬁle name for the configFile parameter are the same.
Republish the Inkdoc so users can retake the assessment.
Doing this reenables the assessment for all of your users. For your EchoInk library users, you can set distribution rules to allow only certain users to retake the assessment.

Reset the Assessment by Editing

Valid only for assessments built with Assessment widget module 2.0.0.

Modifying an assessment built with Assessment widget module 2.0.0 by adding or deleting questions opens the block. Only modiﬁed assessments have the block removed, while unmodiﬁed assessments remain locked. For example, a project has one assessment each in chapters 1-5. If you modify the assessments in chapters 1-3 and republish the project, users could retake the assessments in chapters 1-3 but not chapters 4-5.