Group Import is a Moodle local plugin that allows teachers to import groups and enrol students into them using a CSV file, directly from within a course.

The plugin is designed to be safe, robust, and teacher-friendly, ensuring that:

• only existing users are processed,
• only users already enrolled in the course can be added to groups,
• the import never stops on errors,
• a detailed report is provided after each import,
• guided tours (User Tours) help teachers discover and use the tool effectively.

• Simplify group management for teachers
• Prevent common CSV import errors
• Avoid accidental user creation or enrolment
• Provide clear feedback on successful and failed operations
• Improve adoption through contextual guided tours

CSV Group Import

• Import groups from a CSV file
• Enrol users into groups
• Optional creation of groupings
• Supports ; and , as CSV separators

Safety & Validation

• No user creation through the file
• Nor course enrolment
• Each row is validated independently:
  • user not found
  • user not enrolled in the course
  • user already in group
  • group already exists

Import Report

• Lists successful group enrolments
• Lists errors with clear explanations
• Import continues even if some rows fail

Guided Tours (User Tours)

• Guided tour on the Group Import page
• Guided tour on the course home page (More menu)
• Automatically installed
• Multilingual (English / French)

• Course → More → Group import
• Direct URL: /local/groupimport/index.php?id=COURSEID

Required Columns

Example

useridentifier;groupname;groupingname
jdupont;Group A;Tutorial groups
asmith;Group B;Tutorial groups

1. Open the course
2. More → Group import
3. Download CSV template
4. Upload CSV
5. Select user identifier
6. Start import
7. Review report

• English
• French

Accessible to:

• Teachers
• Editing teachers
• Course managers

• Plugin type: Local (local/groupimport)
• Minimum Moodle version: 4.1
• Compatible with Moodle 4.x up to 5.1

• Guided tours imported if missing
• No duplication of existing tours

MATURITY_STABLE

GNU General Public License v3 (GPLv3)

A public roadmap is available in the project wiki, outlining upcoming improvements and planned features.

Suggestions for additional features, enhancements, or improvements are welcome. Feedback from teachers and/or administrators is encouraged !