List select-enabled System Attributes allow you to create a list selector for your client’s System Attributes to allow for more structured attribute data storage. This is helpful for preventing any incorrect data values entered by the candidate or employee and will ensure the most accurate information persists anywhere that the attribute is configured.

Create list-select System Attributes

List select-enabled System Attributes can be created for Candidate Attributes, Job Attributes, or both.

1. Navigate to the System Attributes page.
2. Open either the Candidate Attributes or Job Attributes lists from the left panel, depending on the custom attribute you want to add.
3. Click + Add Custom Attribute in the top right corner of the page.
   
   
    
4. In the slide-out drawer that opens, enter in the required fields of Attribute Name and Attribute Description.
   • Note: The Key Name auto-populates based on the Attribute Name.
5. Select List Select as the Attribute Type in the dropdown selection.
6. You can then update its privacy settings, if needed, and then enable whether it will be added to reports or not.
7. After selecting the Attribute Type, a new tab for List Select Configuration will display alongside the Attribute Details tab. Open this new tab.
8. Add list-select items in one of two methods:
   1. Manually Add – This will open a new child drawer where you can enter the list items. Once entered, the Value field will automatically populate with that name, but can be edited. Click Add List Item in the bottom right corner to add a child item for the parent attribute.
   2. Upload CSV – This will open a standard system file selector where you can choose from a file on your device. The file will need to meet these template requirements to ensure a successful and correctly mapped upload.
9. Click Create to save and add your list-select attribute.

Edit list select attributes

Once added or uploaded, the mapped items and their values will be listed for you to view. Any updates that will need to be made can occur by clicking the item’s action menu, or three dot icon, and then Edit List Item from the drop-down menu that opens. You can then edit and save the value.

Apply list select attributes

List select attributes can be used in the following system areas:

• Jobs
• Job Data Packages
• Forms
• Conversation Builder
• Workflows

Jobs

Jobs will rely on Custom Candidate Attributes for their list select option(s).

1. Navigate to the Jobs page.
2. Open the preferred job.
3. Click the Screening section of the job.
4. Create a new screening question.
5. Select List Select as the Reply Type.
6. Scroll down to the System Attribute section.
7. Click the System Attribute selector.
8. Click Custom Candidate Attributes and then the preferred list select-enabled attribute.
   • Note: List-select attributes have a list icon next to their name.
     
     
      
9. A warning modal will display. Click Continue.
10. Options inherited from the list-select attribute can be previewed in the configuration drawer prior to saving. Click Save.
    • Note: The options cannot be edited at the question level. All changes to the options must be done within the Attribute configuration
11. Save the Screening section.
12. Click the Unpublished status and select Publish in the dropdown menu that appears.

Job Data Packages

Job Data Packages will rely on Custom Job Attributes for their list select option(s).

1. Navigate to Job Data Packages.
2. Open the preferred package or create a new one.
3. Click + Add Job Data.
4. In the dropdown that opens, scroll down to the Custom Job Attributes section.
5. Select your preferred attribute.
6. Click Apply.
7. The attribute will then be listed under the Included Job Data section in the drawer. Select the preferred option for the attribute for that job data package.
8. If you would like to disable editing of this attribute in the Jobs page, click the attribute’s action menu, or ellipses, and then Disable editing in Jobs from its dropdown.
   
   
    
9. Click Save in the bottom right corner of the drawer.
10. If you are editing an existing package, a confirmation modal will appear. Click Save.

Forms

Forms will rely on Custom Candidate Attributes for their list select option(s).

1. Navigate to the Forms page.
2. Open the preferred Form or create a new Form under the Candidates or Employees list.
3. Click + Add Section.
4. Select Custom in its dropdown.
5. In the new section, click + Add Task.
6. Select Custom Question in its dropdown.
7. Update the section title, if preferred, and then enter in your question in the Type Your Question field.
   • Note: This question should correspond to the preferred list select-enabled attribute selected for this question.
8. Select Single Select or Multi Select as your response type.
   
   
    
9. Click the question’s action menu, or ellipses.
10. Select Field Mapping in its dropdown.
11. A modal will open. In the System Attribute selector, select Custom Candidate Attributes and then the preferred list select-enabled attribute from the list.
    
    
     
12. Enter in the Destination Field, which will be the attribute key name entered for the selected attribute.
13. Click Save.
14. A warning will display. Click Continue. The list items will then be displayed in a preview state for easy review.
    
    
     
15. Make any necessary updates to the custom question before clicking Save in the top right corner of the section.
16. The section will then be added to the form. To finalize the form, click the Draft or Unpublished status in the top right corner of the form you are updating.
17. Click Publish to mark this form as active in the system.

Conversation Builder

Conversation Builder will rely on Custom Job Attributes for their list select option(s).

1. Navigate to Conversation Builder.
2. Open the preferred conversation or create a new conversation.
3. You can then add a new section or navigate to an existing section.
4. Click that section’s action menu, or ellipses.
5. Select System Attribute.
   
   
    
6. In the modal that appears, select the custom list-select System Attribute that will be tied to this question.
7. A confirmation modal will open to confirm it is acceptable for the list-select attribute to overwrite any previous options you might have added to the question. Click Save in the modal. The question type will then update to List Select with the options listed below the question box.
   • Note: You will not be able to make any updates to the list-select options after mapping the Attribute. Any changes to the list items must be made within the attributes setup, not within the conversation.
8. When any and all edits are made to the conversation as needed, click the Draft or Unpublished status and then the Publish button in the dropdown menu that opens.
   • Note: If you remap the question to a new attribute type, then a System Attribute Override modal will display. Click Continue to remap the previous configuration.

Workflows

Workflows will rely on Custom Job Attributes for their list select option(s).

1. Navigate to Workflows.
2. Open the preferred workflow or create a new workflow.
3. Click + Add Task.
4. Enter a name for the task.
5. Click + Add Trigger.
6. Select Candidate Status Updated and then the preferred status for this trigger.
7. After the Start Point bar, click the plus icon and then select Set Attribute Value from the dropdown that appears.
8. A Set Attribute Value box with a selector will then display. Click into the selector and select Custom Candidate Attributes.
9. The menu will open to a new list where you can select your preferred attribute value.
10. Once selected, an additional selector will be listed where you can choose the preferred attribute list value for this corresponding trigger.
    
    
     
11. Click Save in the top right corner of the task.
12. Click the Publish button in the top right corner of the main Workflows page.

Multi-select parent values

In cases where the same child value needs to be mapped to several parent values, a user can multi-select the parent values at the child value-level configuration.

• Example: Child attribute “Department” as value “Product Management” → This child attribute is mapped to parent attribute “Pay Code” → child value “Product Management” needs to be mapped to parent values “PM123,” “PM987,” and “PM456” because any of those pay code’s can be associated to the Product Management Department.

To do this,

1. Navigate to the child attribute you need to edit.
2. Open the Edit Attribute options.
3. Navigate to the List Select Configuration section.
4. Click into Edit List Item for the child value you need to edit
5. View the dropdown the options for parent value.
6. Select all the parent values associated with the child values.

Multilingual List-select Attributes

List-select attribute can be enabled with Multilingual to accommodate for product mapping where the candidate can engage with the client's AI Assistant in multiple languages (i.e. such as a Form in three languages).

Enabling languages

Implementation options

Multilingual variants for a list-select attribute can be implemented via several methods:

1. Initial Language selection - Turning on languages before list item configuration.
2. Language selection post-list item configuration - Turning on languages after your list items have been configured.

Recommendations for configuration

Initial Language Selection is recommended if you plan to upload your list items via the .cvs upload feature.

1. Navigate to the language dropdown.
2. Select the languages that should be enabled.
3. Save your language selections so that languages are now enabled for the attribute.
4. Open to the list-select attribute template.
5. Configure the template as usual for English list items.
   • Note: For every language you’d like to upload list items for, add a new column with the header “list_items_”, followed by the language code (i.e. “list_items_fr” for French or “list_items_de” for German).

Language selection post list item configuration

This is recommended if you need the list items to be auto-translated after the list items have been created. To do this,

1. Configure all your list items in English, either manually or via the .cvs upload option
2. Click the language dropdown.
3. Select the preferred languages.
4. Click Apply.
5. A confirmation modal will appear to confirm the changes. View a list of languages that have been added or removed.
6. Toggle on Run auto-translation for this Attribute to run all configured list items through auto-translation for all configured languages.
7. Click Confirm.
   
   
    
8. The list items will then be translated.
   • Notes:
     • No changes can be made to the attribute until the auto-translations have completed.
     • You can exit the drawer for now while you wait for translations to finish. If you enter back into the drawer before the translations are completed, you will see a “background” translations running component at the top. This will go away once the auto-translations are complete.
       
       

9. After auto-translations have run, review the translations. Click into the options menu and then select Edit List Item to make any edits.
   
   

Note: Due to existing system limitations for the first release of the feature, the Multilingual list select configuration is available for only List-select Attributes which are less than 300 list items. If your Attribute contains more values, or you attempt to upload a CSV with more, an error modal will appear blocking the action.

 

User and candidate experience

If a multilingual list-select is mapped to a question at the product-level (i.e. a Conversation or Form question, for example), then the candidate will be presented with language options.

• For example, if Conversation “Screening” is configured in English, French, and German with associated multilingual list-select attributes mapped to multiple questions, and a candidate comes in and initiates the conversation in French, then the options for the question will present as the French options configured on the attribute.

This can also be validated at the setup when you are configuring an engagement in another language.

• For example, if a multilingual list-select is mapped to Job Screening question for a multilingual job, the preview options will display in the language you have selected on the Job Overview (i.e. viewing a job in German).