Group import (via CSV) icon

Group import (via CSV)

Maintained by Kevin “J”
"Group Import" is a Moodle (local) plugin that allows teachers to import groups and groupings but also enrol students into them using a CSV file, directly from within a course.
Free
Download for free
Supports Moodle 4.2-5.1 See all versions
Latest release: 6 months ago
Installations: 23
Downloads (last 90 days): 43
Frankenstyle name: local_groupimport
Local plugins
📦 Local Group Import (Moodle Plugin)

> Overview

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.
> Goals
  • 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
> "Key Features

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)
📍 How to Access the Tool
  • Course ' More ' Group import
  • Direct URL: /local/groupimport/index.php?id=COURSEID
📄 CSV File Format

Required Columns

Column Required Description
useridentifier Yes Username, email, idnumber, or custom profile field
groupname Yes Group name
groupingname No Grouping name

Example

useridentifier;groupname;groupingname
jdupont;Group A;Tutorial groups
asmith;Group B;Tutorial groups
'‍🏫 User Workflow
  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
🌍 Languages
  • English
  • French
🔐 Permissions

Accessible to:

  • Teachers
  • Editing teachers
  • Course managers
🛠 Technical Information
  • Plugin type: Local (local/groupimport)
  • Minimum Moodle version: 4.1
  • Compatible with Moodle 4.x up to 5.1
🔄 Upgrade Behaviour
  • Guided tours imported if missing
  • No duplication of existing tours
🧪 Maturity

MATURITY_STABLE

📄 License

GNU General Public License v3 (GPLv3)

- Roadmap & Contributions

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 ! 

Contributors