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.
4296 sites
106 fans
Moodle 2.0, 2.1, 2.2, 2.3, 2.4, 2.5, 2.6, 2.7, 2.8, 2.9, 3.0, 3.1

Travis status

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.


Screenshot #0
Screenshot #1


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

Comments RSS

Show comments
  • Picture of James Landrigan
    Tue, 25 Sep 2018, 2:53 PM
    Hi Davo,

    That's great thank you. All fixed.
  • Picture of Matthew Cook
    Thu, 1 Nov 2018, 6:34 AM
    As the administrator of a Moodle instance for a small polytechnic, every few months I get a seemingly random instance of someone getting checklist notification emails when they have no connection to a course (nor do they have any particular role anywhere, unlike James Landrigan's example). I suspect it's happening more often, but people aren't telling me about it. It's never two people getting the wrong notifications at the one time. I'm running the latest version (2018042100) on Moodle 3.4. I'd be happy to provide any debugging related log data you'd like.
  • Davo
    Thu, 1 Nov 2018, 11:14 PM
    Hi Matthew,

    I'm not sure what I can do to investigate this.

    The code in question, does the following when the checklist is complete:
    * Check the user hasn't already completed the checklist in the last hour (so they can't just hammer a tick box to spam lots of emails)
    * Ask Moodle to provide a list of users with capability 'mod/checklist:emailoncomplete' for this activity (or the course / category / system contexts above this), these are the teachers to notify
    * Send an email to the student (if notify student / notify both selected)
    * Send an email to each of the teachers identified (if notify teacher / notify both selected)

    So, for someone to incorrectly receive any email then either the 'emailoncomplete' capability has been allocated to the wrong person OR the core get_users_by_capability() function is going wrong. Most of that function was last updated in 2011, but there are a couple of lines that changed early 2017. I would be very surprised if there was an undiscovered bug in there, but I could be wrong.
  • Al
    Sun, 25 Nov 2018, 11:16 PM
    Please, can you add moodle auto-updater to this plugin? We update moodle every week and have to find the plugin when the others all do it automatically. It would save so much time, thank you.
  • Davo
    Sun, 25 Nov 2018, 11:23 PM
    Hi Al,

    I'm not aware of any reason why updating this plugin would be any different to any other plugin available on I suggest you double-check your directory permissions for the plugin on your server or let me know the exact error message you get when you try to update.
  • Picture of Eric Tanguy
    Tue, 27 Nov 2018, 12:05 AM
    Hi all, is there a possibility for a student to add comments to an item when he check it ?
  • Davo
    Tue, 27 Nov 2018, 12:07 AM
    Eric - no, that is not supported by this plugin. It's an option that could be added, if funding was available to implement this.
  • Picture of Eric Tanguy
    Tue, 27 Nov 2018, 2:42 PM
    Thanks Davo, i understand the problem of funding
    I continue to think about the use i can have with this activity and i have identifed 2 :
    * To validate the progress of a project. But in this case the project is made by several students and it would be usefull if the check could be done for a group
    * To auto-evaluate "competences" by students but just at a course level. In this case it would be usefull to have the possibility to check more than 2 states. Currently each item to ckeck have 2 states "done" "not done" but it could be "perfectly" "partially" "not at all" or more

    I think that what i imagine is not possible ...
  • Davo
    Tue, 27 Nov 2018, 5:00 PM
    Eric - all things that have been suggested before.

    As I spend my working day writing Moodle code, I don't often want to spend my evenings doing it as well. Realistically, the only way I will get around to adding new features is if it is paid work that I can do during my working day.

    I never like it to come down to money, but it is either that, or donating my free time to write these features (which I did in the first place to create the plugins and I still do in order to make sure they keep working with each Moodle release).
  • Picture of Florian Rowedder
    Mon, 4 Feb 2019, 11:32 PM
    it seems to me the behaviour of this plugin is not correct when "seperate groups" mode is selected: The students are not able to add new checklist items then. Is this a bug or am I doing it wrong?
  • Davo
    Mon, 4 Feb 2019, 11:36 PM
    Florian - I'm not sure what you mean.

    If you enable the option 'students can add their own items', then each student should be able to add their own private items to their own copy of the checklist (underneath existing items). These won't show up for any other users and are unaffected by any of the group settings.

    The group settings on the checklist affect the progress reporting page - if set to 'no groups', then all students are shown, if set to 'separate groups' then only students from groups the teacher is part of can be seen (unless the teacher has 'access all groups'), if set to 'visible groups' then a teacher may see the progress for students in all groups.
  • Picture of Leonie Lawson
    Tue, 12 Mar 2019, 7:36 PM
    Hello Davo
    Hopefully this hasn't been asked before. I can't seem to find a similar query. I've uploaded a checklist manually using the cvs file. Some of the items are labels which link to external resources. When a student manually ticks the checkbox next to the label on the main course page, this isn't flowing through to the checklist. Is there a way to make this work? The current settings on my checklist include Check-off when modules complete - "Yes, can override". TIA
  • Davo
    Tue, 12 Mar 2019, 8:05 PM
    Hi Leonie,

    When you manually create items like that and include links to other activities, then as far as the checklist is concerned, that link could be to any arbitrary place on the internet, so it has no way of determining (without a lot of guesswork, that I haven't programmed into it), how to automatically mark the item as complete.

    If you are working with activities on the same course as the checklist, then you can use the setting that imports activities from the current course (or section). If you do that, then the links generated know exactly what activity they are working with and can automatically update when that activity is marked as complete.
  • Picture of Leonie Lawson
    Tue, 12 Mar 2019, 8:16 PM
    Thanks for your quick response Davo. For the purpose of this checklist, I do not wish for items to be automatically updated, but rather the user manually tick the checkbox next to the item on the main course page and for this to flow through to the checklist. Is there a way to do this?
  • Davo
    Tue, 12 Mar 2019, 8:21 PM
    If you want the items to be automatically updated at the point when the linked activity is completed, then you need to follow the steps I outlined in my previous message.

    Whether that activity, itself, was marked as complete by manually ticking the box or automatically by rules, does not make any difference to the checklist update.
Please login to post comments