UKG Ready Career Portal — Embedding Guide

How to properly embed the UKG Ready career portal on your website, and why "refused to connect" errors occur.

Why "Refused to Connect" Happens

If you drop a standard <iframe> tag pointing to your UKG Ready career portal URL, the browser will block it with a "refused to connect" error. This is expected behavior.

UKG Ready's servers reject iframe requests from domains that have not been registered in the system. This is a security measure to prevent unauthorized sites from embedding your career portal.

❌ This will NOT work by itself:
<iframe src="https://secure.entertimeonline.com/ta/MOEVT0044.careers?CareersSearch"></iframe>

Missing two things: the InFrameset parameter and the HostedBy domain registration.

✅ The Fix: Hosted By Configuration

Overview

UKG Ready has a built-in feature called Hosted By Configuration that allows you to register external domains authorized to embed your career portal in an iframe. Once your domain is registered and you use the correct URL parameters, iframe embedding works.

This is a two-part fix:

Register your website's domain in UKG Ready's Hosted By Configuration
Use the correct iframe URL with InFrameset=1 and HostedBy= parameters

Setup Steps

Open the Recruitment Configuration page in UKG Ready Settings > HR Setup > Applicant Tracking/Recruitment > Configuration

Find the "Hosted By Configuration" section Scroll down to the Hosted By Configuration section on the Configuration page.

Add your website's domain Click Add Hosted By and enter your website's URL (e.g., www.yourcompany.com). You can add multiple domains if your career portal will be embedded on more than one website. Click Add Hosted By again to save.

Build the correct iframe URL Use the following URL format. The two key parameters are InFrameset=1 (tells UKG to allow iframe rendering) and HostedBy= (must match the domain you registered in Step 3):

<!-- Career Search — all EINs -->
<iframe src="https://secure.entertimeonline.com/ta/MOEVT0044.careers?CareersSearch&InFrameset=1&HostedBy=www.yourcompany.com"
  width="100%" height="600"></iframe>

Place the iframe code on your website Paste the iframe code into the HTML of your career page. The career portal should now load inside the iframe.

Available Landing Pages

You can embed different views of the career portal by changing the landing page parameter before InFrameset. All examples below assume the domain has been registered in Hosted By Configuration.

View	URL Pattern
All Jobs (all EINs)	`...careers?CareersSearch&InFrameset=1&HostedBy=...`
Jobs for specific EIN	`...careers?CareersSearch&ein_id=XXXXXX&InFrameset=1&HostedBy=...` Replace XXXXXX with the EIN ID number from UKG Ready
Specific Job Requisition	`...careers?ShowJob=XXXXXX&InFrameset=1&HostedBy=...` Replace XXXXXX with the Job Requisition number
Apply to Specific Job	`...careers?ApplyToJob=XXXXXX&InFrameset=1&HostedBy=...`
Jobs Map	`...careers?ShowMap&InFrameset=1&HostedBy=...`

Live Tests

Test A: Raw iframe — No InFrameset/HostedBy WILL FAIL

This demonstrates the error when embedding without the required parameters:

❌ Expected result: "Refused to connect" — the domain is not authorized and the required URL parameters are missing.

Test B: iframe with InFrameset & HostedBy parameters

This uses the correct URL format. It will only work if ukgr-embed-test.pages.dev has been added to the Hosted By Configuration in UKG Ready:

ℹ️ If this still shows "refused to connect," the domain ukgr-embed-test.pages.dev has not been added to the Hosted By Configuration in UKG Ready. Add it to test, or replace with your actual website domain.

Test C: Jobs Map with InFrameset & HostedBy

ℹ️ Same requirement — domain must be registered in Hosted By Configuration.

Troubleshooting

Problem	Cause & Fix
"Refused to connect"	Most common cause: Your website's domain is not registered in UKG Ready's Hosted By Configuration, or the `InFrameset=1` and `HostedBy=` parameters are missing from the URL. Fix: Add your domain in Settings > HR Setup > Applicant Tracking/Recruitment > Configuration > Hosted By Configuration and use the correct URL format.
HostedBy domain doesn't match	The `HostedBy=` value in the URL must exactly match the domain registered in UKG Ready. If your site is `www.example.com`, make sure both the Hosted By field and the URL parameter say `www.example.com` (not just `example.com`).
Works on one page but not another	If you have multiple domains or subdomains (e.g., `careers.example.com` vs `www.example.com`), each domain needs to be registered separately in Hosted By Configuration.
Blank page loads in iframe	Verify the company short name is correct in the URL. Also check that there are active job requisitions assigned to the career portal.
Mixed content warning	Make sure your website uses HTTPS and the UKG iframe URL uses `https://`. Browsers block HTTP content on HTTPS pages.

Alternative: Fancybox Popup (from Career Portal Setup Instructions)

UKG Ready also provides a Fancybox lightbox method on the Instructions tab of the Recruitment Configuration page. This opens the career portal as a popup overlay instead of an inline iframe. It uses jQuery and the Fancybox library hosted on UKG's servers.

⚠️ Note: The UKG-provided code references jQuery over http://. If your website uses HTTPS (it should), change the jQuery script tag to https:// or the browser will block it as mixed content. FIX REQUIRED

The Fancybox method is found at:

Settings > HR Setup > Applicant Tracking/Recruitment > Configuration > Instructions tab > Career Portal Setup Instructions

Summary

Method	Works?	Requirements
Raw `<iframe>` (no parameters)	❌ No	—
iframe with InFrameset + HostedBy	✅ Yes	Domain registered in Hosted By Configuration
Fancybox popup (UKG method)	✅ Yes	jQuery + Fancybox JS/CSS included; fix HTTP→HTTPS
Direct link (new tab)	✅ Yes	None — always works

Recommended approach: Use the iframe with InFrameset + HostedBy method. Register your domain in UKG Ready's Hosted By Configuration, then use the iframe URL with InFrameset=1&HostedBy=yourdomain.com. This gives you a clean embedded experience with no popups or extra libraries needed.