Note: You are currently viewing documentation for Moodle 3.9. Up-to-date documentation for the latest stable version of Moodle may be available here: File handling.

File handling

From MoodleDocs

This page really needs improving. Please see the page comments for suggestions of what to include, then remove this template when you're done.

The way files are handled in Moodle 2.0 has changed from earlier versions. Students and teachers will use the File picker to upload and organize their files in areas called Repositories. Repositories can be located on the Moodle site or externally. Site administrators can reveal, restrict, add, edit or create repositories for the site.

  • Previously, if a file was used in different courses, it was duplicated. In Moodle 2.0, files are stored only once, saving disk space.
  • Full support for Unicode file names on all operating systems.
  • Metadata about each file (author, date, license, etc) and what the file is used for are stored in the database.
  • Files are no longer just "uploaded to the course". Files are connected to the particular bit of Moodle content that uses them. (For example, a file may belong to a file resource, a forum post or a wiki page). Access to these files is controlled by the same contextual rules as as that bit of Moodle, increasing security.
  • File picker has a list (file tree) or icon view

A video on file handling in Moodle 2.0:

How is Moodle 2.0 better?

  • There is no course Files space - good because you don't have to keep it tidy any more.
  • Access to a file is based on the resource or activity to which it's connected; from any context you can easily get to a file - good because you can now easily link to files between areas you have editing access to.
  • You can access the File Picker from many more places - good because it helps to avoid tedious and overwhelming front pages.
  • Deleting a link to a file will delete the file - good because your files area won't become unkempt and unwieldy any longer, and because it will help to keep Moodle's database small.
  • At the same time you can't delete a file which is linked elsewhere - good because it is now impossible to break a link.

Typical Moodle 2.0 workflow

Edit text or activity. Use the file picker to easily select the file from any local or remote repository. The file is then copied to Moodle and stored securely with the text or activity.

Or Edit text or url resource. Use the file picker to select a file from any local or remote repository and select "link". The file URL is then embedded into the text and when viewed, the media comes directly from the open repository.

The standard Moodle install has 4 default areas (repositories) displayed in file picker for the teacher to select:

The site administrator can expand the above list to include 15 other predefined repository areas. For example, the teacher may see a file picker link to a Google Docs or UTube repositories where they can find files. As in the previous versions, the teacher can create a folder structure to store the files at the time files are uploaded.


Caveat: these are just making a start on these. Subject to quality, style and accuracy improvements.

What are ways to make files available to other teachers/designers?

In Moodle 2, this is going to require a change of habits. Some of the philosophy is written up in a small essay on course files here

One approach is to use a repository. One of the easiest to set up is a File System Repository

This needs server access. One such example:


What are ways to make ONE change in a file and have this reflected across a Moodle site?

This also will require a change in thinking. You cannot just go to the file in the file picker and change it's name or upload a new file. This would cause problems if it was linked to elsewhere.

One answer is again to use repositories. Link to the files in the repository. Change the files (according to the permissions on the repository) and this is reflected everywhere in the course instantly.

See also