Embedding your job board on your career site keeps candidates on your website while still using Greenhouse Recruiting to manage jobs, job posts and applications. Depending on the complexity of your setup, it can take between an hour and a day to embed your Greenhouse job board with the support of someone who can edit your company's career page.
If you’re currently using legacy custom CSS to style your Greenhouse job board, follow these steps to embed your Greenhouse job board on your company's careers site before Friday March 13, 2026.
Overview
Embedded job boards offer a modern, accessible, and customizable experience for both internal and external job boards—so you can personalize your job board without custom code. This option uses an iFrame (a website loaded within another webpage) to embed your Greenhouse-hosted job board directly on your careers page.
Use this option if you want to:
- Show your Greenhouse job board directly on your own careers page
- Keep candidates on your site while they browse jobs and apply
- Remove legacy custom CSS while still matching your brand
Embed your Greenhouse job board
Step 1: Configure your Greenhouse job board
In Greenhouse Recruiting, you can upload a logo, format job posts, and configure application questions and fields. These settings control what candidates see inside your embedded job board.
Go to Configure > Job boards and posts, then select the job board you'd like to embed. Select Style and customization to configure what candidates will see on your embedded job board. Learn more about how you can Customize your job board.
Step 2: Add the embed code to your careers page
In this step, work with someone who can edit your company's career page to add two lines of code.
Go to Configure > Job boards and posts, then select the job board you'd like to embed. Select Dev center. Scroll to "Embed code."
On your careers page, paste the container element where you want your job board to appear.
Next, replace YOURTOKEN with your Greenhouse job board token on your careers page. You'll find this near the bottom of your careers page, just before the closing </body> tag.
Step 3: Point tracking links to your embedded job board URL
Once your embedded job board is live, update Greenhouse so your tracking links (and other job board URLs) send candidates to your careers page instead of boards.greenhouse.io.
In your job board's Dev center (Configure > Job boards and posts > Edit > Dev center), add the base URL of the page your job board is embedded on to the "Job board URL" field.
Press "Enter." On the message that appears, click "Update tracking links to the URL below."
Troubleshooting
The embedded job board shows an error message
This is commonly caused by an incorrect or missing job board URL setting. Double-check your base URL in Greenhouse and try again.
We want more control over the layout or UI
If you need deeper control over the job list layout, filtering experience, or the overall UI, an API-driven integration option may be a better fit.