Your Moodle version

Activities: Checklist

Maintained by Davo Davo Smith
A checklist can be created by a teacher (or generated from the activities in a course) and then the students or teachers can check-off each item as they are completed.

This is a Moodle activity module for Moodle 1.9 and Moodle 2.0+ that allows a teacher to create a checklist / todo list / task list for their students to work through. The teacher can monitor all the students' progress, as they tick off each of the items in the list. Items can be indented and marked as optional. Students are presented with a simple bar showing how far they have progressed through the required/optional items and can add their own, private, items to the list. 
Features include:

  • Choose whether students or teachers can check-off items
  • Students can add their own notes to their checklist
  • Dates can be added to items (and exported to the calendar)
  • Teachers can comment on an individual student's items
  • Progress is exported to the gradebook
  • Choice of colours for each checklist item
  • Heading items (without checkboxes)
  • (Optional) Import list of current course activities and automatically check-off as activities completed

There are two other plugins that further enhance this activity:

Video overview of this plugin:

The latest version (and the Moodle 1.9 version) can always be found here: (the version on will be updated from time to time)


This plugin is part of sets Checklist, MoodleCloud.


Davo Smith (Lead maintainer)
Please login to view contributors details and/or to contact them

Comments RSS

Show comments
  • Picture of Paula Moreira
    Sat, Mar 26, 2016, 11:45 PM
    Hi Davo,

    I want the % to show on the block after the bar. is there a simple way to get that? If i open the cheklist i have the % para i wish that could also be seen on the course page. Thanks
  • Davo
    Sat, Mar 26, 2016, 11:58 PM

    If you want to show the percentage in the block, then open up blocks/checklist/block_checklist.php and edit the lines that call 'print_user_progressbar', to change the 4th param from 'false' to 'true' (without quotes). The first call to 'print_user_progress' in that file is for teachers seeing an overview of all students in the course, the second call is for students seeing their own progress bar.
  • Picture of Paula Moreira
    Mon, Mar 28, 2016, 7:52 PM
    Thanks Davo! works perfectly!
  • Picture of Raad Al-Rawi
    Fri, Apr 8, 2016, 10:23 PM
    Hi Davo

    We're using checklist 2.x (Build: 2014080601) with our main University Moodle v2.7.7 and we would very much like to have support for the Book module, so that student progress can be monitored against course content in books.
    We are currently in the early stages of our upgrade to 3.0.x - is this something that is in the Moodle v3 version of checklist, or if not, is it on the roadmap?

    Best regards

  • Davo
    Fri, Apr 8, 2016, 10:35 PM
    There is no particular roadmap of new features for the checklist plugin. I rarely add new features, as it already does most things that people want.

    I'm not clear exaclty what support you are wanting for the book module. Is it just updating the checklist when a book activity is 'complete'? If so, the easiest way to do this is to use the standard Moodle activity completion and my plugin will pick this up automatically. If you can't use this, then someone would need to find the name of the event (if any) that fires when a book is finished, then edit mod/checklist/classes/local/autocomplete.php to add the name of this event.
  • Picture of Matt Polaniecki
    Sat, Apr 16, 2016, 12:20 AM
    Thank you so much for this great plugin!

    My question is when you create multiple checklists for different groups in a course, they all show in the gradebook as expected grades for all students.

    For example, if have Group A, Group B, and Group C in my course, I would create 3 checklists that correspond to those groups. I would then restrict access based on groups so that each group can only see the correct checklist.

    The problem is that in the gradebook, it shows all checklists for all students and would give a 0 to that student if they haven't completed the checklist. Is there a way to filter out the gradebook to only show checklists that were assigned to that group?
  • Davo
    Tue, Apr 19, 2016, 3:32 AM
    Matt - not that I'm aware of. I don't think the gradebook has any functionality built in to it to exclude items related to activities that certain users cannot access (due to groups or other access restrictions).

    Maybe you could take a look on and see if there exists a feature request for that?

    An alternative might be to simply not include any checklist in the gradebook (do this by setting the grade to 0 in the checklist settings).
  • Picture of Ryan Bernstein
    Sat, May 14, 2016, 1:04 AM

    We're hoping to find a way to value the checklist in the gradebook as either a 0 value or a 1. The maximum value of the activity is 1 point, but Moodle seems to round up in the gradebook. For example, if there are 6 checklist items in the activity, and the student completes 4 of them, he gradebook will display a .67% for the grade item. We'd like it to be all or nothing. The student would have to check all 6 items to earn the point. Anything less than 6 is a 0.

    Thanks or any help you can provide.
  • Davo
    Sat, May 14, 2016, 1:49 AM
    Ryan - I think the closest you can get to this, without code changes, would be to use 2 checklists and activity completion. The first would work as it does now, but with the score set to 0. The second would import the activities from the course, but exclude everything except for the first checklist (the second checklist could be put in an orphaned course section to hide it from students). The second would have its score set to 1.

    Once the first checklist was complete the one and only item in the second checklist (i.e. the first checklist itself) would be marked as complete. So, the score for the second checklist would be either 0 or 1.

    Maybe a bit fiddly to implement, but possibly less confusing than adding another setting to the checklist module to cover this use case ...
  • Picture of Simon Bertoli
    Fri, Jul 8, 2016, 11:24 AM
    Hi Davo

    Is there a plan to bring this over to the mobile app?
  • Davo
    Fri, Jul 8, 2016, 2:34 PM
    Simon, I don't know anything about developing for the mobile app and probably don't have spare time to investigate. If someone wants to do the coding and send it to me, or pay for the development, then I'd be happy to add it.
  • Picture of Simon Bertoli
    Fri, Jul 8, 2016, 4:29 PM
    No problems Davo, ill look into it

  • Picture of Joseph Spilatore
    Wed, Jul 27, 2016, 10:36 PM
    Hello All, I am finally getting around to testing the checklist module and excited to implement for our users. has anyone experienced the issue of all site users being displayed in a checklist module within a course? I checked student and authentic user permissions. current moodle version 2.4 -checklist version 2014011500. Any guidance is greatly appreciated
  • Davo
    Wed, Jul 27, 2016, 10:41 PM
    Joseph. The checklist uses the standard 'get_users_by_capability' function to find all users with the given capability at the module level. If you are getting all users on the site then either all users are enrolled on the course, all users have a student role at the site level, or you have changed the 'authenticated user' role to give everyone the ability to update every checklist on the site.
  • Picture of Adele Shemberger
    Sat, Sep 24, 2016, 12:18 AM
    Hi Davo,

    Thank you again for this tremendous tool. We are using the checklist in each of our courses.

    We are an asynchronous program, so students begin and complete courses at any given time in the semester. Our new practice is to suspend student users upon completion of the course, and we export all user grades at semester end into one spreadsheet.

    In all areas of Moodle a suspended user is invisible, but in the checklist they still show as an active student. Is there anyway they can be removed from the checklist progress view once they are suspended?

    In the link below you can see two students who have been suspended in Moodle, (outlined in red) and do not show in the grader report, but still show as active in the checklist. As more students finish this will become really messy.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
Please login to post comments