Embedded One-Click Check #

What Is the Embedded One-Click Check? #

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):

When Should I Use This? #

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:

• Employee onboarding portals — trigger background checks as part of your hiring workflow
• Recruitment and staffing agency websites — allow applicants to self-serve their own checks
• Internal HR systems — streamline intake forms so background checks are initiated at the same time as data collection
• Branded experiences — offer a seamless, Worker Checks–powered experience without redirecting users to another site

Your Embed Credentials #

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].

How to Implement #

1. Copy the script snippet from your Business Hub (or from the example below) and paste it into your website’s HTML where you want the button to appear.
2. The embed loads automatically — it injects a styled “Start Background Check” button and a secure popup form. No additional configuration is required for basic use.
3. Optionally, pre-populate candidate details from your own form fields using the JavaScript API (see the Advanced Example below). This is useful if you already collect the candidate’s name or email in your onboarding flow.
4. Test the integration by clicking the button on your page and confirming the popup form appears correctly. Submit a test entry to verify the invitation email and SMS are received.

Basic Example #

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>

Advanced Example — Pre-Populating Candidate Details #

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>

What Happens After a Candidate Submits? #

When a candidate completes the form, Worker Checks automatically:

• Sends an invitation email to the candidate with a link to complete their NCCHC application
• Sends an SMS notification to the candidate’s mobile number
• Creates a pending invitation in your Business Hub dashboard so you can track progress

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.

Requirements #

Frequently Asked Questions #

Can I change the default background check product? #

Yes. Contact [email protected] and let us know which product you’d like as your default (for example, Standard NCCHC instead of Volunteer).

Can I use the Embedded One-Click Check on a public website? #

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.

What if the popup doesn’t appear? #

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.

Can multiple staff members use the same embed credentials? #

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.