Overview
Gem ATS provides you with an automatically-generated job board to host all of your open jobs, which you can integrate into your website in a number of ways. This article covers the various integration options available, to help you understand which option is best suited to your organization’s needs.
For details of how to configure a hosted or embedded job board, as well as job posts and application forms, check out Gem ATS: Configure your job board.
Requirements
- Your team must use Gem ATS.
- You must be a Gem Admin.
Integration options
There are three options for creating a job board in Gem ATS, and the right option for your organization will depend on your goals and technical requirements. Those options are:
- Using the job board hosted by Gem.
- Embedding a job board into your website.
- Using the Gem Job Board API to create a custom page.
For options 1 and 2, the customization options are limited to what’s available in Gem. If you want to customize your job board further, for example sorting jobs by department, we recommend using option 3 - the Job Board API.
Over the rest of this article we will go through each option in turn, providing some context for each one along with details of how to go about setting it up.
Option 1: Use the hosted job board
The quickest and simplest way to start using your job board, requiring no technical knowledge, is to link out to the auto-generated URL from anywhere in your website.
This version of your job board will be hosted on jobs.gem.com, however you can customize the rest of the URL to fit your organization. By default, Gem will automatically populate the URL with your organization’s name - we recommend keeping this as part of the URL for the purpose of clarity.
Follow these steps:
- Select your account at the bottom of the main sidebar, then select the Admin settings option in the dropdown.
- Select the Gem ATS header.
- Select the Job boards & posts tab.
- Select the Customize your job board section to expand it.
- Change the second part of the Job board URL if needed.
- Select the Copy URL button.
- Use this URL anywhere you link out to your job board, or share it with your web developer.
Note that all of the customization options discussed in Gem ATS: Configure your job board will apply to hosted job boards.
For an example of a hosted job board, check out the Excelity careers page.
Option 2: Embed the job board on your website
If you want to embed your Gem job board on your company website, a Notion page, or another platform, you can generate the necessary embed codes in Gem that you can copy and paste into your website. Once embedded, the job board will display using all of the customization you applied earlier.
This option requires access to your website’s code in order to drop in the code snippets.
Follow these steps:
- Select your account at the bottom of the main sidebar, then select the Admin settings option in the dropdown.
- Select the Gem ATS header.
- Select the Job boards & posts tab.
- Select the Embed job board section to expand it.
- Copy each of the provided codes and share them with your web developer or site administrator.
- Alternatively, if you have access to your website to do this yourself, we recommend adding the first snippet into the
<head>section of whichever page you want to embed the job board into, and the second snippet into the<body>section.
Note that the color options discussed in Gem ATS: Configure your job board will apply to embedded job boards, but the rest of the customization options available (such as Page title, Company logo, and Intro text) will not.
For an example of an embedded job board, check out the Tropic careers page.
Option 3: Build a custom job board with the Job Board API
Gem’s Job Board API allows you to generate a list of live job posts that you can embed on a web page of your choice, and customize however you want.
This requires familiarity with RESTful APIs, but allows a developer to completely customize what to display on the job board, and how jobs are filtered. You can also use this method to include a tracking pixel on your job board.
Refer to Gem ATS: The Job Board API for details of how to use the Job Board API to create a custom job board.
Note that the customization options discussed in Gem ATS: Configure your job board will not apply to a job board integrated using the API.
For an example of a job board integrated using the API method, check out the Gem careers site.
Additional resources
To learn more about job boards in Gem, check out the following articles:
Have any issues or questions on this topic? Please feel free to contact your dedicated Gem Customer Success Manager directly or our Support team at support@gem.com.