.. _The Files Page:

#########################
Guide to the Files Page
#########################

.. tags:: educator, reference

You manage most files for your course, including image files, on the **Files**
page. This page lists the files that you have added, along with the
following capabilities and information regarding the files:

.. image:: /_images/educator_references/FilesPageTableView.png
 :alt: an image of the Files page in Studio. Each page shows up to 50 files
     and includes a Search box, sort and filter capabilities, an Add files
     button, and checkboxes so that you can bulk delete or bulk download files.

* A checkbox for Download and Delete bulk actions
* A thumbnail of the file
* The file name
* The file size
* The file type
* An indication of whether the file is :ref:`locked<Lock a File>`.
* The three dot menu allows you to copy the Studio URL, copy the web URL,
  lock the file, click on the Info button, and delete a file
* The Info button within the three dot menu allows you to additionally see
  the date added and details about whether the file is within the course as
  well as the number of times it appears in your course.

.. image:: /_images/educator_references/FilesPageInfoPop.png
 :alt: When you first select the three dot menu, then select Info, this
     Info modal appears. The Info modal provides details such as date added,
     file size, Studio URL, Web URL, ability to lock a file, as well as usage
     data within the course.

This page also includes a **Search** option to help you find specific files.
For more information, see :ref:`Find Files`.

.. _File Size:

*********
File Size
*********

The maximum size for each file is 10 MB. We recommend that you use standard
compression tools to reduce PDF and image file sizes before you add the files
to your course.

You can upload multiple files at a time.

If you have very large audio files or large data sets to share with your
students, do not use the **Files** page to add these files to your course.
Instead, use another hosting service to host these files.


.. _Find Files:

*********************
Find an Uploaded File
*********************

The **Files** page lists up to 50 files at one time.  If your course has more
than 50 files, additional files are listed on other pages.

To find a file on the **Files** page, you can use the **Search** option, or
you can view the page that lists the file.

* To use the **Search** option, enter one of the following search terms in the
  **Search** field.

  * The full file name.
  * The file name extension, or file type.
  * Part of the file name. You can also enter multiple parts of a file name.

  For example, if the file is named **FirstCourseImage.jpg**, you can enter any
  of the following search terms in the **Search** field.

  * ``FirstCourseImage.jpg``
  * ``.jpg``
  * ``First`` ``Image``
  * ``First`` ``.jpg``

You can also sort files by Name (A-Z), Name (Z-A), Newest, Oldest, File size
(low to high), or filter files by Type (Code, Images, Documents, Audio).
For more information, see :ref:`Sort Files` or :ref:`Filter files`.

.. _Sort Files:

**********
Sort Files
**********

.. image:: /_images/educator_references/FilesPageFilterAction.png
 :alt: an image of the Sort options, which include Name (A-Z), Name (Z-A),
     Newest, Oldest, File size (High to low) and File size (Low to High).
     Selecting Apply will sort the files accordingly.

On the **Files** page, you can sort your files by Name (A-Z), Name (Z-A),
Newest, Oldest, File size (high to low), and File size (low to high).
To sort by one of these, select what you wish to sort by and click Apply.

.. _Filter Files:

************
Filter Files
************

You can filter files by type so that only a selected type of file is
visible. The list remains in the current sort order.

You can filter by the following file types.

.. list-table::
   :header-rows: 1
   :widths: 10 20

   * - Type
     - Possible File Name Extensions
   * - Audio
     - .aac, .mpeg, .mp3, .ogg, .wav
   * - Code
     - .css, .html, .json, .php, .sql
   * - Documents
     - .pdf, .txt, Microsoft Office and Open Office documents, presentations,
       spreadsheets
   * - Images
     - .gif, .ico, .jpg, .jpeg, .png, .tif, .tiff

To filter the list of files by type, follow these steps:

#. On the **Files** page, click the Filters button.
#. In the list, select the checkboxes for the types of file that you want.

The list refreshes to show only the type or types of file you selected.

To reset the list and view files of all types, clear all checkboxes.


.. seealso::
 
 :ref:`Add Course Files` (how-to)

 `Manage Course Files <https://docs.openedx.org/en/latest/educators/how-tos/manage_files.html>`_ (how-to)

**Maintenance chart**

+--------------+-------------------------------+----------------+--------------------------------+
| Review Date  | Working Group Reviewer        |   Release      |Test situation                  |
+--------------+-------------------------------+----------------+--------------------------------+
|              |                               |                |                                |
+--------------+-------------------------------+----------------+--------------------------------+