The Worker Checks Embedded One-Click Check allows you to embed a "Start Background Check" button directly on your own website or internal portal. When a visitor clicks the button, a secure popup form appears where they can submit their details to begin a Nationally Coordinated Criminal History Check (NCCHC) — all without leaving your site.
When a candidate submits the form, an invitation email and SMS are sent to them automatically, guiding them through the Worker Checks application process.
This is how the button will appear on your page (preformatted in the script):
The Embedded One-Click Check is designed for websites and portals that sit behind your firewall or require authentication to access. Common use cases include:
These credentials are unique to your Business Hub account. You will find them in your Business Hub under Settings → Embedded One-Click Check.
The Default Product determines which background check is initiated when a candidate submits through your embed. To change the default product, contact [email protected].
Paste this snippet into your HTML where you want the "Start Background Check" button to appear. Replace the placeholder credentials with your own Embed Key and Embed Secret from the credentials section above.
<!-- Worker Checks Embedded One-Click Check -->
<div id="worker-checks-embed"></div>
<script src="https://app.workerchecks.com/embed/one-click-check.js"
data-embed-key="YOUR_EMBED_KEY"
data-embed-secret="YOUR_EMBED_SECRET">
</script>YOUR_EMBED_KEY and YOUR_EMBED_SECRET with the actual credentials shown in your Business Hub account.
If your portal already collects candidate information (such as name and email), you can pass those values into the embed so the candidate doesn't need to re-enter them. Use the JavaScript API to set fields before the popup opens.
<!-- Worker Checks Embedded One-Click Check (Advanced) -->
<div id="worker-checks-embed"></div>
<script src="https://app.workerchecks.com/embed/one-click-check.js"
data-embed-key="YOUR_EMBED_KEY"
data-embed-secret="YOUR_EMBED_SECRET">
</script>
<script>
// Pre-populate candidate details from your form
WorkerChecksEmbed.setCandidate({
firstName: document.getElementById('candidate-first-name').value,
lastName: document.getElementById('candidate-last-name').value,
email: document.getElementById('candidate-email').value
});
</script>When a candidate completes the form, Worker Checks automatically:
The candidate then follows the standard Worker Checks application process — including biometric identity verification — and you'll be notified in your Business Hub when the check is complete.
| Requirement | Details |
|---|---|
| Business Hub account | You must have an active Business Hub account |
| Website access | Webmaster or developer access to edit the HTML of the page where the embed will appear |
| Internal network only | The page must be behind a firewall, VPN, or require authentication — not publicly accessible |
| HTTPS | Your website must use HTTPS for the secure popup to function correctly |
Yes. Contact [email protected] and let us know which product you'd like as your default (for example, Standard NCCHC instead of Volunteer).
No. The embed includes your credentials in the page source, which means anyone who can view the page source can see your Embed Secret. For public-facing websites, contact us to discuss a server-side integration or alternative solution.
Check that your page is served over HTTPS and that no browser extensions or Content Security Policy (CSP) headers are blocking the embed script. If you're still having trouble, contact us with your browser, operating system, and a screenshot of any console errors.
Yes. The Embed Key and Secret are tied to your Business Hub account, not to individual users. All invitations submitted through the embed will appear in your shared Business Hub dashboard.