Address History can be captured, validated, and displayed as a collection of date ranges when added to a candidate form. This helps to prevent gaps in the candidate’s timeline and provide an overall easier user experience.

Use cases

• Admin users who want candidates to input a complete range of address data to maintain proper compliance.

Date format note

The date format is only collected as MM/YYYY. This will be used to validate a range configured time span by month.

• Start Date – Saved as the first day of the month.
• End Date – Saved as the last day of the month.

Configuration

Configure the Work Experience Timeline by following the steps below.

1. Navigate to the Forms page.
2. Open the preferred form.
3. Click + Add Section.
4. Select Address Timeline from its drop-down menu.
   
   
    
5. When added, this section comes pre-configured with the following form questions. Click the settings icon in the top right of the section. 
   • Question asking if they had an address change
     • MULTILINGUAL APPLICATION Note: The responses to the first question will be uneditable until we can enhance our multilingual conditioning.
   • Address task
   • Date Range task
     • Note: These questions cannot be deleted or disabled.
       
       
        
6. From the Required Time Frame selectors, choose the time frame in which candidates will need to enter in their current and previous addresses and that will be validated as a continuous history of dates. Any number of months and years can be selected for the time frame.
   
   
    
7. (Optional) You can set a section condition in order to allow applicable candidates to skip the Address Timeline section entirely. To set conditions, 
   1. Toggle on the Add Condition setting.
   2. Set the necessary conditions that would cause a candidate to skip this section entirely. Learn more about adding conditions here.
8. Enter in the instructions for this section, which will display to the candidate if they meet the conditions for this section (if set). You are able to update the font and formatting of this section, link out to any relevant URLs, and add tokens as needed.
   
   
    
9. Set the Fill Gap Title for a fill gap section in the timeline. As gaps are identified when candidates begin to enter in their relevant addresses, an exclamation point will display in the timeline and a Fill Gap card will display in the History panel. Once a candidate clicks on the Fill Gap card, the empty gap entry will display where the candidate can update this information. This title is listed at the top of this section to the candidate.
   
   
    
10. Enter the Fill Gap Instructions, which are the instructions presented to the candidate notifying them that a gap exists in their address history that they need to fill out.
    
    
     
11. Click Apply in the bottom right corner of the drawer.
12. If relevant, you can add the following task questions to this section:
    • Address
      • Note: Any additional address task added will be saved in a single string to the attribute.
    • Custom question
    • Date selection
    • Display text
13. Save the section.
14. Add additional sections as needed.
15. Publish the form.

Pre-configured conditioning

The address timeline questions are pre-configured based on the candidate’s selection to the first address question.

• If Yes is selected – The remaining address questions show.
• If No is selected – The remaining address questions will be hidden.

Add additional conditions

While you cannot remove this pre-configured condition, you do have the option of adding conditions onto it. To do this,

1. Click the condition icon for the Address question.
2. A slide-out drawer will open. Add an +AND and/or +OR condition and/or click + Add Rule Set to add an entire rule set.
   
   
    
3. Click Apply to add the changes.

Learn more about adding conditions here.

Attribute mapping

Attribute mapping within this section will be read-only, as the Work Experience Timeline is defaulted to the Address attribute for all accounts. 

Candidate experience

When a candidate comes to the Address History Timeline section of their form, the section instructions will display for them to review. They will then need to complete the steps below.

1. Click + Add History to begin entering in their work history.
   
   
    
2. Answer the first address question, which will determine the questions that are displayed after it.
   • Question: Did you have an address during this time?
   • Answers: 
     • Yes – If selected, then the remaining address questions show. Continue to step #3.
     • No – If selected, then the remaining address questions will be hidden. Click Next Section to finish the form.
3. Fill out the information for this specific address.
4. Click Create in the bottom right corner of this entry.
   • Note: The Street Address Line 2 field in a form will populate when a candidate searches by apartment, building, or unit number.
5. After the address is added, a timeline will appear at the top, indicating the completed portion of the timeline and the remaining gaps. The History panel underneath the timeline will also list the entered addresses and empty gaps in chronological order. Click + Add History next to the History panel title to add additional entries.
   • Note: Candidates can complete their address history in any order.
     
     
      
6. Enter the additional address details.
7. Click Create to add the entry to the timeline.
8. Repeat this process for all addresses.
9. Click Next Section to complete the rest of the form.
    

Pre-filled resume values

If the candidate included their current address on their uploaded resume and that resume was parsed, then those values will pre-fill the first entry and automatically be added to the History section’s cards for the candidate.

The candidate will then be directed to complete the first required value from the address card so that they can add their first address to the timeline.

Maximum responses allowed

Candidates can enter a maximum of 50 responses for their address history.

If they exceed this number, a modal will appear notifying them that they have reached the maximum number and to reach out to their hiring manager if they need to add more experience.

Fill address history gaps

As candidates enter in their address history, Fill Gaps will be listed in the History panel when there are missing entries in the designated time frame. Candidates can continue to add history by clicking the + Add History button or they can fill the listed gaps by clicking each Fill Gap card and entering in the missing information.

When a Fill Gap card is clicked, the screen will auto-fill the date range with the associated time frame gap and include the fill gap title and description for the candidate to review before completing these details.

Add new history when current history is incomplete

If a candidate clicks the + Add History button before they have clicked the Create button for the current entry details, then a new entry will open and the information for the previous entry will be saved within the History panel with an error state listing the number of missing required fields for easy review.

Remove an entry

A Remove button will be listed in the top right corner of every entry. At any time, a candidate can open the entry from the History panel and then click this button. A warning modal will then display where they can click the Remove button to finalize the entry’s removal.

Moving forward with an incomplete history

If the candidate attempts to move forward in the form without completing their entire history, then a warning modal will display, notifying them that they must complete their history before moving forward.