Skip to content Skip to main navigation Skip to footer

Automatically Rejecting Video Files Based on a Defined Specification

Due to the wide range of methods of producing video files, they can vary in quality drastically. Although in guidelines in the Nucleus CMS it is possible to specify file criteria, sometimes this is not enough and the task for admin users to QC and review video files is not a small one. Therefore it is possible on a per instance basis to restrict the video specification and for Nucleus to automatically reject files that do not automatically meet the spec after upload. To enable this on your instance, please create a support ticket and request to automatically reject video files including the required criteria.

How does Nucleus Automatically Reject Video Files

The first step is to decide on the criteria of the files that you want entrants to provide. The following criteria can be used as part of the specification:

  • Resolution – for example: HD 1920-1080
  • Codec – for example: H264 Progressive
  • Sound – for example: AAC 44KHz
  • File Type – for example: .mov or .mp4

Note – the size of the file can be restricted on a per question basis and this functionality is covered in the Media Library guide

Nucleus can only scan the metadata in the file when it has completed upload.

  • If the file meets the requirements then it is accepted and no action is taken
  • If the file does not meet the requirements then an email is sent to the user and the file is automatically deleted

How to Set up The Rejection Email Template

For full information on managing email templates review the email template guide. To ensure that emails are sent to users when their videos are rejected admin users will need to set up the mediaItem/fileAssociationRemoved template.

In this template explain to the user that the file they provided did not meet the required specification, that the file has been deleted and that the entrant needs to provide a new file. We recommend also including the specification.

To personalise the email you can include the following special values alongside the usual values:

  • @@mediaItem_title@@ – inserts the title of the media item as provided by the entrant
  • @@mediaItem_id@@ – inserts the id of the media item

Once the copy and subject have been provided and the template enabled it will be sent to entrants when their videos are rejected.