Can I create an experience based on a student's eligibility application?

When a coordinator places a student into a Work-Based Learning (WBL) experience from the Work-Based Learning Eligibility workflow, the system can automatically prefill the placement form using data the student already entered on their eligibility application. This article explains how that prefilling works and how to configure your eligibility forms so the right fields are captured.

Last updated About 3 hours ago

Overview

Place Student opens the standard New WBL Experience form with values pulled from the student's most recently completed eligibility submission for the selected WBL type. This will:

  • Show a summary of what was read from the eligibility form

  • Match an existing employer and employer contact in your database

  • Prefill placement fields such as job title, start/end dates, and hourly rate

  • Offer to create a new employer or contact if no match is found

You can use ‘Place Student’ from:

  • Pending Eligibility → action button (…) → Approve and Place (approves eligibility, then opens the prefilled placement form)

  • The eligibility rubric modal → hover over ApproveApprove and Place

  • Student Eligibility → action button (…) → Place Student


Prerequisites

For prefilling to work:

  1. The student must be eligible for the WBL type you are placing them into.

  2. The student must have a completed eligibility application submission for that type.

  3. The eligibility form must include fields with the correct prefill field names (see below).

  4. The eligibility template must be linked to the WBL type under WBL Eligibility settings.

If no completed submission is found, you can still place the student manually; the form simply will not be prefilled.


Configuring Your Eligibility Form

Recommended: Use the form builder prefill names

The easiest approach is to assign prefill field names in the form builder when editing your eligibility template. These options automatically set the field name the system expects.

Important: The field name must be empty before setting the prefill in order for automatic naming to be applied.

When adding a field on an eligibility form:

  1. Open the form template in the form builder.

  2. Select the field that should feed into placement (employer name, contact email, start date, etc.).

  3. Assign the appropriate prefill class from the class dropdown (labels appear as (Employer) Company Name, (WBL Exp.) Start On, and so on).

  4. Save the template.

The form builder assigns field names. You do not need to rename fields manually when using these options.

Alternative: Hand-name fields with a prefix convention

If you are not using the form builder prefill classes, you can name fields manually using any of the field names listed in the next section.

Hyphens in field names are treated the same as underscores (employer-company-name = employer_company_name).


Supported Field Names

Employer / company

Field name

What it prefills

employer_company_name, employer_name

Employer name

employer_street, employer_address_1

Street address

employer_city

City

employer_state

State (normalized to 2-letter abbreviation)

employer_zip

ZIP code

employer_email

Company email address

employer_phone

Company phone number

Employer contact

Field name

What it prefills

employer_first_name , employer_contact_name

Contact first name

employer_last_name , employer_contact_last_name

Contact last name

employer_full_name

Contact full name (used when first name is empty)

employer_email , employer_contact_email

Contact email

employer_title , employer_contact_title

Contact job title

employer_work_phone , employer_contact_work_phone

Contact work phone

employer_cell_phone , employer_contact_phone

Contact cell phone

Placement details

Field name

What it prefills

wbl_experience_job_title , job_title , title

Student’s Job Title

wbl_experience_start_on , start_on , start_date

Start On

wbl_experience_end_on , end_on , end_date

End On

wbl_experience_hourly_rate , hourly_rate , pay_rate

Hourly Rate (also sets Is Paid when rate > 0)


How Employer Matching Works

When Place Student opens, the system reads the employer name from the eligibility form and tries to find a matching employer in your database:

  1. Exact match — case-insensitive comparison of the full name

  2. Normalized match — punctuation and extra characters are ignored (so Company Name matches “Company" Name)

  3. Suggestions — if no exact match, similar employers are listed as clickable suggestions and loaded into the employer dropdown

When an employer is matched, the system also tries to match a contact at that employer by email first, then by first name.

If no employer match is found but employer data exists on the form, you can check create employer to add a new employer from the form data when you submit. The same option exists for contacts.


What Coordinators See in the UI

Summary panel

At the top of the placement form, a panel titled From eligibility form lists each value read from the submission with its field label (for example, Employer Name: Acme Corp).

A note explains that fields with a blue label below were prefilled from the eligibility form.

Blue labels on form fields

Form fields that were automatically filled show a blue pill-style label. If a coordinator changes a prefilled value, the blue highlight is removed for that field.

Changing the employer clears the contact prefill highlight, because the contact list is reset for the newly selected employer.


Tips for a Smooth Setup

  1. Use form builder prefill classes whenever possible; they prefill the correct names automatically and are the most reliable option.

  2. Collect employer name and contact email at minimum; these drive employer/contact matching.

  3. Use consistent employer naming in your database and on forms (minor punctuation differences are handled, but very different names will not match).

  4. Include placement dates and job title on the eligibility form if you want those fields prefilled on the experience record.

  5. Test with a real submission — open Place Student for a student who has completed the eligibility form and confirm the summary panel and blue labels reflect your field names.