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.