Referrals and Referral Links
28 min
any user or employee can add a referral or create a referral link in ashby from their home page, regardless of their permissions this article explains how to add direct referrals, create and track referral links, configure your referral form and settings, and report on referral data share this guide with your users to give them more information on adding referrals via ashby permissions and access users without a paid seat can add referrals and create referral links users do need to have an ashby account to add referrals custom referral filters are available on the legacy plus, plus, and enterprise plans foundations legacy plus plus enterprise ❌ ✅ ✅ ✅ direct referrals vs referral links with a direct referral, you add one candidate's details at a time and submit them to be reviewed for a role with a referral link, you post the job board or a specific job posting to your network (for example, on linkedin), and ashby credits anyone who applies via that link to you adding a direct referral watching this video is optional — the written steps below cover the same content you can refer a candidate directly for a role in the referrals section of the home https //app ashbyhq com/home/upcoming page the referrals section of the home page navigate to the home page and find the referrals section click + referral select + add direct referral when adding a direct referral, you need to add the candidate's name and email address and the specific role they are being referred for the form to refer a candidate directly you can also upload a resume and add their phone number, a link to their website, and any notes an admin can customize the referral form, so you may see some additional or different options here from the form pictured ashby automatically adds a referred candidate to the application review stage in the candidate pipeline for the specified role when submitting a direct referral, the job field shows job posting titles when available if the job posting title isn't available (for example, if the job posting is unlisted or unpublished), the job field shows the job title adding a referral from the top menu you can also add a referral directly to a role by hovering over the + add button from the top menu and selecting referral adding a referral using add on the navigation bar once you click referral , you need to add the candidate's name and email address and the specific role they are being referred for, just like in the process above creating a referral link referral links allow you to post a link to a specific job posting (or to the job board in general), and ashby automatically credits candidates who apply via that link to you a good use case for referral links is sharing a job to a social media platform or another wider forum watching this video is optional — the written steps below cover the same content you can create a referral link in the same referrals section at the bottom of the home https //app ashbyhq com/home/upcoming page referrals section at the bottom of the home page navigate to the home page and find the referrals section click + referral select + create referral link when creating a referral link, you can opt to either have the link direct to a specific posting or to all open job postings listed on your job board to create a link for a certain posting, check the link to specific job posting checkbox, then select the posting from the drop down menu that follows to have the link direct to your job board with open postings, leave this box unchecked when creating the link your job posting must be published and listed on your external job board before you can link to it with a referral link creating a referral link tracking referrals you can view all of your personal referrals and their application status by clicking all referrals https //app ashbyhq com/referrals/direct/active from there, you can view active referrals (those still in the pipeline), archived referrals (those who have been archived or rejected), and hired referrals use the radio buttons to view each list of referrals accordingly all referrals will only show the referrals you have submitted to see how to pull a list of all active referrals submitted by all users, check out the reporting options below # direct referrals referrals that the user has added directly to ashby from their home page referrals from referral links referrals that applied via the user's referral link referral links a list of all current referral links with the option to copy them to clipboard active a toggle to view all active referrals (referrals currently in the interview pipeline) archived a toggle to view all archived or rejected referrals hired a toggle to view all hired referrals candidate the candidate's name referred for the role they were referred for submitted at when the referral was added status the current stage the candidate is at in the pipeline add referral the option to add another referral tracking and amending referral links you can head to the referral links https //app ashbyhq com/referrals/links section in all referrals to view and amend your referral links title the name of your referral link job posting the job posting your referral link leads to (if applicable) referrals number of referrals who applied via this referral link referral link the referral link itself referral form and settings you can edit your referral form and set referral settings in admin > sourcing > referrals https //app ashbyhq com/admin/organizational settings/referral forms referral settings the referral settings referral settings allow you to set limits on allowing referrals you can set the following rules allow all referrals ashby adds the referral to a job consideration in a lead or active stage that already exists for the candidate (if applicable) ashby creates a new job consideration if there isn't an existing one to match the referral to the candidate is being considered for the referred job if the candidate has an existing job consideration in any stage of the role they're being referred for, ashby prevents the referral the candidate already exists in ashby ashby prevents referral submissions for existing candidates, even if no one has considered them for the role if a user tries to submit a referral that your rules disallow, they receive a message letting them know that ashby hasn't allowed the referral, with details of the settings in place the error shown when a user tries to add a candidate already in ashby use the allow referral links? option to determine whether users can create referral links the restrict referral status? option determines whether all users referring candidates can view their current interview stage if enabled, only users with the appropriate permissions to view the candidate profile can view their current interview stage the allow referral links toggle restricting referral statuses so only specific information is visible adding filters to specify the roles that can accept referrals you can specify criteria to determine the roles that users can submit referrals or generate referral links for switch on the allow referrals only for specific jobs? option click add field to match select the determining fields and configure your criteria any jobs matching this criteria can accept referrals or can be used to generate referral links switching on referrals for specific jobs for example, in the pictured case, users can only submit referrals for jobs in the engineering department setting referrals to only be available for specific jobs and setting the criteria ashby applies your criteria on top of your existing referral settings, and added criteria doesn't impact existing referrals or existing referral links referral confirmation email ashby only sends referral confirmation emails to candidates submitted via the direct referral option those who apply via a referral link receive an inbound application confirmation instead (if enabled) ashby also doesn't send this to existing candidates if a user adds the referrer manually via the credited to field on the candidate profile if you'd like referred candidates to receive a confirmation email at the point of submission select your email template using the referral confirmation dropdown this sets the referral confirmation icon to enabled use preview email to preview the email sent to the referral, or click edit email to be taken to the email template to make further edits adding a referral confirmation email editing your referral form click on your default referral form to make any amendments, such as adding or removing fields or adjusting the title of the form click on the default referral form within your referral settings to edit it the candidate's name, job, and email address are required fields and you can't remove them you can add the following field types to your default referral form short answer single line of unformatted text ashby auto populates linkedin url responses on the candidate's profile long unformatted answer multiple lines of unformatted text phone only domestic or international phone numbers email only valid email addresses multiple choice select a single option checkboxes select multiple options date only dates that a user can select via a date picker yes/no yes, no, or, if not required, no answer number only allows whole numbers (e g , 1) or decimals (e g , 1 5) resume upload a single file and set it to the candidate's resume field you can only add this once to a form candidate's location set the candidate's location you can only add this once to a form other location allow another location to be added to the form url a clickable link to a website file upload a single file file upload questions support files up to 50 mb in standard document, image, and video file types such as documents pdf, doc, docx images jpg, jpeg, png videos common video formats such as mp4 ashby doesn't support executable file types (such as exe) and certain text based formats (such as md) if a candidate needs to submit content in an unsupported format, we recommend converting the file to a supported document type, such as pdf, before uploading candidate's education history see the candidate's education history you can only add this once to the form when adding the candidate's education history field to your form, you can specify the information asked for you can opt to include or exclude the school, degree, field of study, start date, and end date fields as needed check the allow multiple entries checkbox to allow those completing the form to add multiple qualifications you can also set a minimum and maximum number of entries using the min and max fields the education history section of the form where you can specify the details asked for information added to this field always completes the education section of the candidate's profile it's not possible to create additional referral forms if you'd like to add additional questions, edit the default referral form reporting on referrals below are some examples of reports you can run to view key referral data referrals leaderboard to track referrals in intervals, by the user who referred them, navigate to reports > build report and select count over time subject job considerations time field and interval job consideration's started at, to show \[insert your chosen time range here] per \[set your interval here] filter job consideration's source type is referral grouped by job consideration's credited to an example of a referrals leaderboard report viewing all currently active referrals to see a list of currently active referrals from all users, navigate to reports > build report and select custom list subject job considerations filter job consideration's source type is referral, job consideration's outcome equals active fields to show job consideration's candidate, job consideration's job, job consideration's credited to, plus any additional fields you'd like to include an example of a report showing all active referrals faqs a candidate i've referred has disappeared from my referrals list — where are they? head into all referrals https //app ashbyhq com/referrals/direct/active and be sure to check the archived and hired lists if a user rejects or hires the candidate, they no longer show in the active list how do i delete a referral link? to delete or edit the title of a referral link, head to your referral links https //app ashbyhq com/referrals/links , click on the title of the link in question, and then click the red trash can icon to delete it deleting a referral link using the trash can icon you can't restore referral links after deletion links already shared outside of ashby continue to work, but ashby doesn't credit new applications submitted via these links to you the deletion doesn't impact past applications if a user refers a candidate after they've applied for a role, how are sources attributed? if a candidate applies for a role, then an ashby user refers them for the same role, the original source (in this case inbound applied) remains on the candidate profile ashby updates the credited to field so the referrer's name is included on the job consideration the attribution section of a candidate's profile if you allow users to refer candidates that have already been considered for the role, you can opt to use the referred by field when reporting to ensure that your reporting still includes these referrals, despite the initial source listed in the source field can a referral be edited once the candidate has been submitted? if the referrer has access to view and edit the candidate's profile, they can make any corrections or updates as needed to candidate information if the referrer is unable to view the candidate profile or make adjustments, they need to reach out to a user with access to make these updates for them once they submit the referral can i add in a referral on behalf of another user? no, the referrer needs to log into their own ashby account to refer the candidate ashby always credits the candidate to the user who added the referral or generated the referral link an admin can amend the user in the credited to field within the candidate profile if needed is it possible to change out the source added to referrals or referral links? no, the source applied is fixed if you would like to create a link that applies a custom source, check out tracking the source of an application docid\ xhgtzhhc5az2c48vkii8h can referrals be submitted via the integration for slack? no, this isn't currently possible i see a referral i submitted is now in the archive stage — can i view any feedback? we recommend reaching out to the hiring manager or person in your organization responsible for managing the role's pipeline for further information how do i set up application requests to go out to direct referrals automatically? we don't support adding application requests directly in the referral confirmation sent to referred candidates if you add the {application request link} substitution token to your organization's referral confirmation template https //app ashbyhq com/admin/organizational settings/referral forms , the email fails instead, for direct referrals, we recommend configuring an application request automation https //docs ashbyhq com/application requests#configuring application request automation with conditions specifying that the job consideration is a direct referral (for example, job consideration's is direct referral is yes ) you can also opt to configure a catch all for candidates who don't have an application completed by a certain stage (for example, setting a condition field to be job consideration's reached stage type with the value as active ) to ensure any candidates in active stages are prompted to submit an application for the job consideration if you create application request automations for referrals, we recommend disabling your referral confirmation template you can use the application request automation instead to send the referral confirmation and application request in a single email an example of an application request automation for direct referrals