Users of your Pressbooks network may occasionally receive errors when attempting to upload certain file types. Read on for more information on:
Pressbooks is not designed to function as a file storage/publication platform. If users would like to refer to or provide links to files for demonstration or learning purposes, we generally recommend that they host these files externally — Youtube, Vimeo and campus-provided media streaming services are good choices for video and large audio files, and sites like GitHub, Google Drive, Box, or Dropbox offer good cloud hosting options that should meet most users needs to host and refer to external files in their books.
While Pressbooks allows users to upload certain types of media files to a book’s media library and embed/include them within their books, users are limited in the types of files that can be uploaded to Pressbooks. We do this because many file types can pose a potential security risk to readers and other users of the network.
As a result, you or a user on your network may receive the error: “Sorry, this file type is not permitted for security reasons.”
This error will appear when a user attempts to upload media to their book that isn’t included in the list of permitted file types for your network.
As a network manager, you can verify the reason why a file wasn’t able to upload by following these steps:
- Navigate to Tools > Debug File Validation from the left sidebar menu of the book dashboard
- Click Choose File and upload the file that caused the error
- Click Upload
You will receive an Analysis report that lists out why the file wasn’t accepted. This list may include the following:
- WordPress will not process this file based on its name
- This file type is not allowed
If you feel that users should be able to upload file types that are not permitted by default on your network, you can request that additional file types/file extensions be whitelisted on your network. Whitelisting additional file types on PressbooksEDU networks can only be done by Pressbooks staff, and any requests will be reviewed for security concerns before we make a decision about whether to allow these files to be uploaded across the network. Network managers can request that additional file types be added to your network’s file upload whitelist by contacting our premium support desk.