Custom Fields

custom fields allow you to add additional fields to a candidate's profile, a job, an offer, or an opening that you and other users can fill out, allowing for a further level of customization permissions only organization admins can create custom fields candidate, job, and project custom fields can be configured on the legacy plus, plus, and enterprise plans foundations legacy plus plus enterprise ❌ ✅ ✅ ✅ archive reason custom fields can be configured on the plus and enterprise plans foundations legacy plus plus enterprise ❌ ❌ ✅ ✅ custom fields overview the video above walks through creating a candidate custom field and viewing it on the candidate profile you can find a walkthrough for creating and viewing each custom field type below creating custom fields object types custom fields can be associated with six primary object types in ashby object type description candidate these fields are used to capture details specific to individual candidates they appear on the summary tab of the candidate profile job these fields are used to capture details specific to individual jobs they appear on the settings page of a job offer these fields are used to capture details about an offer they appear on the offer activity that appears when a candidate is in the offer stage opening these fields are used to capture details specific to individual openings they appear at the bottom of the opening form projects these fields are used to capture details specific to projects the custom fields show within the settings section of the project employee these fields are used to add additional information to user profiles on the employees page custom fields for employees can be accessed on the basic info tab creating custom fields candidate custom fields when you add a custom field for candidates, it appears on the summary tab of their profiles, ready to fill out new custom fields also apply retroactively to existing candidate profiles, as well as new ones candidate custom fields can be used for adding information like preferred name, full legal name, pronouns, and more! field types field type description yes/no toggle yes or no short answer input a single line of text date select a single date multiple choice select a radio button checkboxes select one or more checkboxes number input a single numeric value currency determine a currency or select a default currency long unformatted answer input multiple lines of text url add a url into this field employee a single select dropdown showing all employees in your ashby instance create a candidate custom field navigate to the candidate custom field view, then click + new in the top right corner of the page the custom fields page open on the candidate tab a configuration form appears with the following options title name your field description optionally, add a description that appears below the title field type (see options above) once you create the custom field, you see additional options when editing it editing a candidate custom field is private? if checked, only those with elevated access or organization admin access can view the field this could be used for fields with sensitive information like candidate salary expectations substitution token create a token to pull data from this field into an offer letter or e signature document if you opt to generate a token for a multiple choice custom field, you get a follow up option, customize substitution text more on this in custom fields docid\ qpgklrscmzgwc 7krbwds below enable in email templates? if checked, the data can be included in emails ashby creates a token that you can add to email templates to pull this information over more on this at substitution tokens docid\ p8ax 2lzye5qh7grothr6 this option is not supported for checkbox and long unformatted answer custom field types show in chrome extension? if checked, the field is accessible in the chrome extension and within ashby the option show in chrome extension? is only available for candidate custom fields find candidate custom fields on the candidate profile once created, candidate custom fields appear on the summary tab of the candidate profile these fields can also be used in email templates https //app ashbyhq com/admin/organizational settings/email templates as custom tokens in the interview briefing https //app ashbyhq com/admin/interview/interview briefing settings as custom viewable fields in searches and reports finding a candidate custom field on the summary tab of their profile creating custom fields job custom fields job custom fields can be created to add additional internal information about a job just as with a candidate, you can fill in the field title, add a description, and pick a field type for data input with a job custom field, you have the additional field type option of a number range field types field type description yes/no toggle yes or no short answer input a single line of text date select a single date multiple choice select a radio button checkboxes select one or more checkboxes number input a single numeric value currency determine a currency or select a default currency number range a range of numbers with a lower and upper bound long unformatted answer input multiple lines of text url add a url into this field employee a single select dropdown showing all employees in your ashby instance create a job custom field navigate to the job custom field view, then click + new in the top right corner of the page to open the new custom field menu the custom fields page open on the job tab a configuration form appears with the following options title name your field description optionally, add a description that appears below the title field type determine the type of information that should be added to this field is required? if checked, the job cannot be opened or moved out of its draft state unless this field is completed when editing the custom field, you see additional options editing a job custom field is private? if checked, only those with elevated access or organization admin access can view the field require reapproval? if the value in this field is changed and you have an approval process in place for the job, reapproval is required substitution token create a token to pull data from this field into an offer letter or e signature document if you opt to generate a token for a multiple choice custom field, you get a follow up option, customize substitution text more on this in custom fields docid\ qpgklrscmzgwc 7krbwds below restrict which jobs include this field? here you can set criteria using filters only the jobs meeting your set criteria have this custom field enable in email templates when enabled, you can pull the content in this custom field into an email generated from an email template this option is not supported for checkbox and long unformatted answer custom field types more at substitution tokens docid\ p8ax 2lzye5qh7grothr6 find job custom fields on the jobs' settings once created, the custom field shows in the settings tab within a job newly added custom fields show for all jobs, regardless of when you created the job these fields can be used finding a job's custom field within the settings section of a job in searches and reports to record job specific requirements or preferences if you try to open a job without completing required job custom fields, you see a missing value message when amending the job status you can create and amend a draft job without completing the required fields creating custom fields offer custom fields navigate to the offer custom field view, then click + new in the top right corner of the page to open the new custom field menu the custom fields page open on the offer tab you can add offer custom fields to an offer to collect additional information from a candidate optionally, set these fields up as tokens to automatically populate information in the candidate's offer letter for more information on creating offer letters, visit offers and offer letters docid\ klimfx9n1tahebvkmgpoh field types field type description yes/no toggle yes or no short answer input a single line of text date select a single date multiple choice select a radio button checkboxes select one or more checkboxes number input a single numeric value currency determine a currency or select a default currency long unformatted answer input multiple lines of text url add a url into this field employee a single select dropdown showing all employees in your ashby instance create an offer custom field title name your field description optionally, add a description that appears below the title field type (see options above) depending on type selected, an options panel may appear is required? determine if the field must be filled out once you create the custom field, you have additional options when editing it too editing an offer custom field instructions if instructions are provided on the offer custom field, this shows to team members when they fill out a candidate's offer (instead of showing the custom field's description) these instructions can also be set with rich text formatting, which also shows when filling out the candidate's offer require reapproval if the field's data is changed, the offer must be re approved substitution token create a token to pull data from this field into an offer letter or e signature document if you opt to generate a token for a multiple choice custom field, you get a follow up option, customize substitution text more on this in multiple choice custom fields customize substitution text # below default value determines the default value to use when this field is used in a fillable form the default value can only be pulled from a custom field with the same field type (for example, multiple choice in this case), or it can be set to a static value instead hide this field if a default is chosen? if a default value is found using the default value option above, hide this field in the offer form make this field non editable? if a default value is selected, then the field cannot be overridden manually within the offer details restrict which offer forms include this field? specify which jobs or departments should display this custom field on offers find offer custom fields on the candidate profile when you click create offer on the profile for a candidate in the offer stage, the field shows on the create new offer pop up these fields can be used to capture specific offer details or terms to replace fields in docx, pdf, and dropbox sign e signature requests to record special instructions or notes related to the offer viewing a custom offer field when completing offer details multiple choice custom fields customize substitution text if you opt to generate a token for a multiple choice custom field, you have the option to customize the text added by the token to your offer letter or e signature document, depending on the choice selected for your custom field once you generate the token within the substitution token section of the custom field, click customize substitution text to open the customize substitution text window the window shows each option that can be selected for your multiple choice custom field customizing substitution text for an offer custom field select an option from the options list, then add in the text that should replace the substitution token within the offer letter or e signature document when that option is selected within the offer details for example, if you select full time for the offer, the token becomes "full time employment" when added to the offer letter template if you don't want the token to be replaced by text for specific options, toggle on the replace with no text option this option removes the token from the document and doesn't add substitute text in its place setting a custom field value to be replaced with no text click save to save any amendments made to the option substitution text make sure to save amendments to each option as you go to avoid losing your changes the number of custom text options set for each option appears within the customize substitution text button for your reference so here, text options have been set for two out of the four options available creating custom fields project custom fields you can add custom fields specifically for your projects use these to specify and house information in your project's settings page you can show these custom fields as additional columns when viewing projects, or filter by custom fields as needed field types field type description yes/no toggle yes or no short answer input a single line of text date select a single date multiple choice select a radio button checkboxes select one or more checkboxes number input a single numeric value long unformatted answer input multiple lines of text url add a url into this field employee a single select dropdown showing all employees in your ashby instance creating a project custom field to create a custom field for your projects, navigate to custom fields https //app ashbyhq com/admin/organizational settings/custom fields/project within admin , then click the projects tab click new to create a new custom field the custom fields page open on the project tab when creating a new custom field, you add the following editing a project custom field after creating it title the name of your field, used for filtering and the header if you add a column for this custom field to your project description a description that shows internally to clarify the information to be added to this custom field field type specify the format of the information added to this field is required? does this information need to be included? show in project list by default? check this if the custom field should be shown as a column when viewing your project list completing project custom fields to add information to the custom fields on a project, navigate to sourcing > projects click the project in question, then click settings your custom fields appear under the basic info section viewing a project custom field within the settings section of a project if a custom field is set as required, you see a warning message below an empty field requesting that you select an option or complete the field a required project field that has been left blank if a required field was previously filled and the information is removed, when navigating to another field, you see a message prompting you to complete the field if you navigate away from the page leaving the field empty, the field reverts to containing the previously entered information filtering by a project custom field to filter by a project's custom field, ensure that the advanced toggle is on for filtering from there, click add field to match to select the custom field you'd like to filter by filtering projects by the custom field once you select the filter, specify the field information you want to use to find specific projects selecting the project custom field to filter by creating custom fields opening custom fields you can create openings custom fields to add additional internal information about an opening just as with a job, you can fill in the field title, add a description, and pick a field type for data input with an opening custom field, you have the additional field type option of a compensation range learn more about openings in openings management docid\ ksxxwi1zugaw8lrp8jwxz field types field type description yes/no toggle yes or no short answer input a single line of text date select a single date multiple choice select a radio button checkboxes select one or more checkboxes number input a single numeric value compensation range a compensation range and interval number range a range of numbers with a lower and upper bound long unformatted answer input multiple lines of text url add a url into this field employee a single select dropdown showing all employees in your ashby instance create an opening custom field navigate to the opening custom field view, then click + new in the top right corner of the page creating an opening custom field a configuration form appears with the following options title name your field description optionally, add a description that appears below the title field type determine the type of custom field you'd like to configure is required? if checked, an opening cannot be moved from its draft state unless the required field is completed when editing the custom field, you see additional options editing an opening custom field substitution token click the click to generate token button to create a substitution token for this custom field restrict which openings include this field? set criteria here to determine the openings that should include this field you can edit default opening custom fields to set them as required you can't set criteria to limit the jobs that include default fields find opening custom fields on openings once created, the custom fields appear at the bottom of the opening form when clicking the draft tab below the opening id to adjust the opening status, if any required fields aren't completed, you see a missing value message you can create and amend a draft opening without completing the required fields the missing value message appears only when you change the opening status creating custom fields employee custom fields when adding custom fields for employees, these show on the basic info tab of each user's profile on the employees https //app ashbyhq com/admin/users page field types field type description yes/no toggle yes or no short answer input a single line of text date select a single date multiple choice select a radio button checkboxes select one or more checkboxes number input a single numeric value long unformatted answer input multiple lines of text url add a url into this field employee a single select dropdown showing all employees in your ashby instance create an employee custom field to create an employee custom field, navigate to admin > organization setup > custom fields and select the employees tab click + new in the top right corner of the page the custom fields page open on the employee tab a configuration form appears with the following options creating a new employee custom field object type specified as employee title name your field description optionally, add a description that appears below the title field type select the field type from the drop down to determine the information that should be added to this field when editing an employee custom field after creating it, you see an additional option enable in email templates? if checked, the data can be included in emails ashby creates a token that you can add to email templates to pull this information over this option is not supported for checkbox and long unformatted answer custom field types more on this at substitution tokens docid\ p8ax 2lzye5qh7grothr6 substitution tokens are not supported for checkbox and long unformatted answer custom field types completing the field on a user profile to access the employee custom field, navigate to the employees page, then click a user's profile you can find custom fields on the basic info tab of their profile viewing a custom field on the employee's profile creating custom fields archive detail custom fields you can create custom fields to capture additional data when archiving or rejecting a candidate in ashby this option is only available on the plus and enterprise plans field types field type description yes/no toggle yes or no short answer input a single line of text date select a single date multiple choice select a radio button checkboxes select one or more checkboxes number input a single numeric value currency determine a currency or select a default currency long unformatted answer input multiple lines of text url add a url into this field employee a single select dropdown showing all employees in your ashby instance create an archive detail custom field navigate to the archive detail custom field view, then click + new in the top right corner of the page the custom fields page open on the archive detail tab a configuration form appears with the following options creating an archive detail custom field title name your field description optionally, add a description that appears below the title field type (see options above) depending on type selected, an options panel may appear is required? determine whether a value must be added to this field when editing an existing archive detail custom field, you see some additional options editing an archive detail custom field is private? determine whether or not all users can see this field, or if only those with organization admin or elevated access admin private access can see this field restrict which archive forms include this field? if you check this box, you can set criteria for when this field should appear when archiving a candidate for example, you could opt to add a filter based on archive reason, so if a candidate gets a competing offer, you can add further details for your reference click + add field to match to select the field to filter by, then specify the value or values for your criteria find archive detail fields when archiving a candidate if you click archive on a candidate's job consideration to reject them, your archive details custom fields show on the archive form the archive reason custom field shows when selecting an archive reason for a candidate if you have restricted the archive forms that include your custom fields, only those that meet your criteria display your created fields listing archive form details in custom list reports once you complete the archive form, you can run reports using your archive detail custom fields to view this information you can either display your archive detail custom fields on a report (as fields to show) or use them as filters on a report for example, you could build a custom list report, filtering for archived candidates, then opt to add your archive detail custom fields as fields to show so this information is easily accessible navigate to reports > build reports > custom list subject job considerations time field and interview job consideration's started at to show \[insert your chosen time range here] per \[set your interval here] filter job consideration's outcome is archived fields to show job consideration's candidate, job consideration's job, and any archive reason custom fields you'd like to include you can also opt to include information like the furthest stage group reached and the job consideration's archive reason an example of a report with archive form custom field details included faqs i can't view a custom field i should see what do i do? check with an organization admin to see if the is private option is enabled for that field they can either disable it or adjust your permissions how do i archive or restore a custom field? you can archive or restore a custom field when editing it click the archive/restore button in the top right corner of the field to take the appropriate action why can't i archive certain custom fields? default custom fields (e g , reason for outreach) cannot be archived check for the default tag when editing them to identify default fields how do i sort my fields? fields appear in the same order they appear on the custom fields page in admin if you use a multiple choice or checkbox field, you can sort the options alphabetically or in reverse alphabetical order can i show information added to a candidate custom field to an interviewer on their interview briefing? yes navigate to admin > interviewer briefing info from there, you can select the fields you'd like to show to your interviewing panel when they look at the interview briefing want to get this information from the candidate's application form? check out our guide on form field connectors docid\ hdnnc9znj8gsr0fjxuyqn to find out how to link application form fields to candidate custom fields can i import data into custom fields when importing via the bulk csv importer? yes you can select custom fields at the mapping stage find more information on custom fields in our custom fields docid\ qpgklrscmzgwc 7krbwds guide i have a lot of custom fields — what filtering options are available? when filtering custom fields, you can filter by status (active or archived), by field type (e g , yes/no, short answer), or by field source (e g , a custom offer field syncing over from an integration human resources information system (hris)) can i use archive detail custom fields to migrate and map greenhouse rejection questions? yes, ashby maps greenhouse rejection questions as archive detail custom fields during migration if you need to have these remapped, reach out to your customer success manager (csm) or support\@ashbyhq com mailto\ support\@ashbyhq com