References

An application template can ask applicants for references. The applicant names their referees in the application, Full Fabric emails each referee a private link, and the referee fills in a reference form without logging in. Staff can follow every request, act on behalf of a referee, and waive references that cannot be collected.

Reference Templates

References are organised in reference templates, managed on the Reference Templates sub-tab of the template's references tab (Reference Template Requirements). Every application template gets one automatically. Add Reference Template adds more when you need different kinds of reference, for example one academic and one professional.

Setting Default Description
Name Reference The name the applicant sees, translatable per language.
Min 2 How many referees must be valid, sent or submitted (see below).
Max 2 How many referee slots the applicant gets. Must be greater than 0 and at least the minimum.

Each reference template has two forms that staff can edit with the form builder:

  • Reference request form: what the applicant fills in about the referee. It starts with first name, last name and email address, all required system fields.
  • Reference form: what the referee fills in.

Reference templates can be reordered. A reference template that already has reference requests cannot be removed.

Template Settings for References

References are switched on with the References tab when the template is created. The Details sub-tab of that tab (Setup for references) holds:

Setting Description
Tab name The name of the references tab, per language.
Reference requests manually sent before application submission: the applicant sends each request. automatically sent on application submission: every valid, unsent request is sent when the application is submitted.
references required before submission? With manual sending, the minimum number of references must be submitted (or waived) before the applicant can submit. On by default.
Reference deadline No deadline, Specific date, or Relative date: a period After application close date or After class application close date.
Send weekly email reminder for pending references Emails referees who have not submitted yet, while the deadline has not passed (or, with no deadline, while the template is open).
Instructions Text shown to applicants on the references tab, per language.

What the Applicant Has to Do

When an application is created, it gets one empty reference request per slot (the maximum number of each reference template). The applicant fills in the referee's details and sends each request. Submission checks, per reference template:

Rule Error the applicant sees
At least the minimum number of requests are valid "At least 2 valid reference requests required"
At least the minimum number of requests are sent (skipped when requests are sent automatically) "At least 2 valid reference requests need to be sent"
At least the minimum number of references are submitted, when required before submission "At least 2 references are required, please ensure your referees have submitted their references"

Submitted and waived references always count towards each rule.

The Referee's Side

Sending a request emails the referee instructions and a private link. The referee opens the link, completes the reference form (including any file uploads), and submits it. On submission, the referee receives a confirmation email and the applicant is notified that the reference arrived.

Reference Request Lifecycle

A reference request is either not sent or sent (it has a send date). The reference inside it has its own state:

Referee details can be edited only while the request is not sent. To change the referee after sending, use Replace.

Actions on a Reference Request

Staff find these on each reference request of the application: send reference request (or resend reference request), Reset reference request, Replace reference request and View referee form, plus a State menu with Submit, Unsubmit and Waive.

Action Who When Effect
Send Applicant, or staff with applics.application_reference_request_send Reference not yet submitted Emails the referee and records the send date. Sending again re-sends the email.
Reset Applicant, or staff with applics.application_reference_request_reset Reference not submitted or waived Clears anything the referee entered, invalidates the old link, emails the referee about the reset, and returns the request to not sent. Send it again to issue a new link.
Replace Applicant, or staff with applics.application_reference_request_replace Request sent, reference not submitted or waived Removes the request and sends a new one to a different referee in the same slot.
Submit (on behalf) Staff with applics.application_reference_submit Any time Marks the reference submitted as the staff member.
Unsubmit Staff with applics.application_reference_unsubmit Reference submitted Returns the reference to not_submitted.
Waive Staff with applics.application_reference_waive Any time Marks the reference waived. It counts as submitted for every rule.

An organisation contact who started the application on the applicant's behalf can send, reset and replace requests like the applicant.

Note: Reading the content of a submitted reference needs applics.application_view_referee_form. Every send, reset, replace, submit, unsubmit and waive is recorded in the reference request's history.

Completion

References count towards the application's completion percentage, up to the minimum number of each reference template. What counts as complete depends on the template settings:

Settings A reference counts once
Sent automatically on submission The referee's details are valid
Required before submission The referee has submitted it
Neither The request has been sent

A waived reference always counts. Each submit, unsubmit or waive recalculates the percentage.