The Resume Upload Widget
A public, embeddable form that lets applicants submit their resume directly into your Careers workspace.
The Resume Upload Widget
The Resume Upload Widget is a public, hosted form your applicants visit to submit themselves into your Careers workspace. Drop the embed code on your career-services site and applicants can self-serve — no manual intake by your team required.
This page covers configuration and embedding from the staff side, and ends with what your applicants will see.
Where to configure it
Settings → Resume Upload Widget. Three controls plus an embed snippet, in the order you'll set them up the first time.
Enable / disable the widget
The Enable widget master toggle at the top of the page turns the public URL on and off.
- On (default): the widget is live. Anyone with the embed link sees the form.
- Off: the embed link returns an "unavailable" state instead of the form. Use this for maintenance windows, or to pause intake during a hiring freeze.
Disabling does not break the embed code on your site — it just changes what visitors see when they hit it.
Assignment strategy
The Assignment section controls how new applicants who arrive through the widget get routed to your team.
Choose one of four strategies from the Strategy dropdown:
| Strategy | Behavior |
|---|---|
| Leave unassigned | New applicants land in the inbox with no owner. Use this if your team prefers to triage manually. |
| Assign to a specific user | Every new applicant goes to the same teammate. Useful when one person owns intake. |
| Round-robin | Each new applicant goes to the teammate whose most recent assignment is the oldest — i.e., it spreads load over time. |
| Capacity-based | Each new applicant goes to the teammate with the fewest currently-assigned applicants. Use this when you want to balance current workload, not historical fairness. |
You can change the strategy at any time. It only affects applicants who arrive after the change.
Notifications
The Notify admins on new applicants toggle sends an email each time the widget produces a new applicant.
Turn it on when your team wants to know about every submission as it lands. Turn it off when the volume becomes noise — assignment will still notify the teammate the applicant was routed to.
Sharing the widget
The Share the widget card is where you copy what you'll paste onto your site. It has three controls — an auto-send toggle, a single-line direct link, and the full iframe embed code.
Auto-send Skills Report email
Above the link and the snippet, the Auto-send Skills Report email toggle decides whether new applicants who arrive through the link receive their Skills Report automatically.
- Off (default): submissions land in your workspace and your team chooses when to share the Skills Report. See Coaching with the Skills Report for the manual flow.
- On: as soon as Careers finishes extracting skills, the applicant receives a secure email with their Skills Report.
The toggle works by adding a parameter to the Direct link and Embed code below — both update in real time as you flip it. Copy whichever one matches the toggle state you want.
{% hint style="info" %} Auto-send is on the link, not on your organization. The toggle isn't saved on your organization — it only changes what gets copied. If you turn the toggle on and copy the link, every applicant who arrives through that link gets auto-sent. If you turn it off and copy the link, no one does. Update the embed on your site to change the behavior for future submissions. {% endhint %}
Direct link
The Direct link is the widget URL on its own — a single line you can paste into an email, an SMS, a button on your site, or any plain-text channel.
Click Copy to copy the URL.
Embed code
The Embed code is a copy-paste iframe snippet that renders the widget inline on any HTML page — typically a "Submit your resume" or "Get started" page on your career-services portal:
<iframe
src="https://careers.mapademics.com/resume-upload?key=YOUR_PUBLIC_API_KEY"
style="border:0;width:100%;min-height:600px"
title="Upload your resume"
></iframe>Click Copy to copy the snippet. The iframe is responsive: it occupies the full width of its container and auto-grows to fit the form's content as the applicant steps through it.
The public API key
The widget URL embeds your organization's Public API Key (the key=… query parameter). The key tells the widget which organization the submission belongs to.
Manage the key under Settings → Organization Settings:
- Copy copies the current key to your clipboard.
- Rotate generates a new key and immediately invalidates the previous one.
{% hint style="info" %} Rotating breaks any embed currently in the wild. After rotation, every page that already embeds the old key will start showing the "unavailable" state — until you replace it with the new snippet from Settings → Resume Upload Widget. Plan rotations during a maintenance window and update every embed at the same time. {% endhint %}
Reasons to rotate: you suspect the key has been pasted somewhere it shouldn't be, you're decommissioning an old site, or you've cycled vendors and want a clean break.
What your applicants see
Applicants who hit the widget URL see a clean, three-step submission wizard:
- Upload — they drop a resume onto the form. Accepted formats are PDF, DOC, or DOCX, up to 10 MB. The headline tells them they're uploading to your organization — the org name is interpolated into the page heading from the API key.
- Review — they confirm the parsed details before submitting.
- Done — confirmation that the resume has been received. If you turned Auto-send Skills Report email on when you copied the link, the applicant will receive a separate Skills Report email once skills are extracted in the background — typically within a few seconds of submitting.
To the right of the form, a benefits panel co-branded with Mapademics explains what the applicant can expect: skill extraction, matching to live job posts, and review by your team.
The widget never shows admin controls, applicant profiles, or anyone else's data. It is purpose-built for one job: a single applicant submitting a single resume.