Jobs on Your Website: the Jobs Embed

Show your open jobs, a job page and the application form on your own website with two lines of code.

Feature Guide
Updated Nov 14, 20266 min readBy Sebastian Streiffert
Who has it
Workspaces that run Bemanning, or Consulting with recruiting on. Elsewhere the embed says the career page does not exist.
Turn on
Nothing to switch on. It shows what your career page shows, as soon as a job is published.
Costs
Nothing. No API key, no credits.

The jobs embed puts your open jobs on your own website. Visitors see the list, open a job and apply without leaving your site. Applications land in Recruitment exactly like those from the career page.

  1. Copy the embed code with your workspace address.
  2. Paste it where the jobs should appear on your site.
  3. Publish a job. It shows up within a minute.

Add the embed to your site

The code is a placeholder element and one script. data-lumen-jobs holds your workspace address: the part after /jobs/ in your career page address. Paste both lines into the page, in the place the jobs should appear.

Embed code
<div data-lumen-jobs="northwind-staffing"></div>
<script async src="https://lumenbase.io/lumen-jobs.js"></script>

Jobs on your website

Paste this code on your own site to show open jobs and take applications.
Embed guide

Embed code

<div data-lumen-jobs="northwind-staffing" data-endpoint="https://api.lumenbase.io"></div>
<script async src="http://127.0.0.1:38681/lumen-jobs.js"></script>
The Jobs on your website card: the code with your workspace address and the API origin filled in, and a copy button

Delivery shows this card where the career site is managed, with your own address in the code.

Show one job

Add data-post with the job's address to show only that job and its application form, for example on a campaign page. The job's address is the last part of its career page link.

One job
<div data-lumen-jobs="northwind-staffing" data-post="truck-driver-gothenburg"></div>
<script async src="https://lumenbase.io/lumen-jobs.js"></script>

Pages that add content later

On a site that builds the page after it loads, call window.lumenJobs.scan() once the placeholder is on the page. Each placeholder is set up once, so calling it twice does no harm.

What visitors see

  • Open jobs: every published job inside its publish dates that is listed on the career page, newest first, up to 200. Above six jobs a search box filters them by title and place.
  • Each row shows the title, then the place, Remote or Hybrid, the schedule, the employment form and Apply by, when the job has them.
  • A job page: the title, the same details, the description with its headings, lists and bold text, and the application form.
  • See all open jobs goes back to the list. The browser Back button works too, and the address ends in #lumen-job= and the job, so a visitor can share it.
The jobs are read through the public jobs API and cached for up to a minute, so a job you publish or close can take a minute to appear or disappear.

The application form

The form follows the job's own apply rules. It is the short version of the career page form: it asks only for the fields below.

FieldAsked
First name, EmailAlways, required
Last nameAlways, optional
PhoneWhen the job asks for it, required or optional as the job says
MessageWhen the job asks for it, up to the job's character limit
CVWhen the job asks for it. PDF, DOC or DOCX, up to 5 MB
ConsentAlways. The applicant ticks the same consent sentence as on the career page, with your company name and how many days the application is kept

The consent sentence is stored with the application, as on the career page. When the career page's Job post block has a privacy policy link, the form shows it under the consent.

When the form sends visitors elsewhere

  • A job that takes applications on another site shows Apply on the company site instead of the form.
  • A job whose form requires more than the short form asks (a required question, profile field, section or attachment) shows Apply on the career page, which opens that job on your career page in a new tab.

After sending

The applicant sees the same thank you as on the career page. The application is in Recruitment under the job, with the source Career page. The same Automations and webhooks run as for any application.

Language

The embed's own text (buttons, labels, messages) is in English, Swedish, Ukrainian or Portuguese. It picks the language from, in order:

  1. data-lang on the placeholder, for example data-lang="sv".
  2. The language of your page, from <html lang="...">.
  3. The visitor's browser languages.
  4. English.

Job titles and descriptions are shown as you wrote them. They are never translated. A label without a translation yet shows in English.

Look

The embed takes your career site's design system: the career page's own, else its site's, else the workspace default. Without one, buttons and links take your workspace's brand colour.

To use other colours on your site, set the variables on .lumen-jobs in your own stylesheet. They win over the design system.

Your own colours
.lumen-jobs {
  --lumen-accent: #0b5cad;
  --lumen-radius: 4px;
  --lumen-font: "Inter", sans-serif;
}
VariableUsed for
--lumen-accentButtons, links, focus rings
--lumen-accent-fgText on buttons
--lumen-fgText
--lumen-mutedThe details line and hints
--lumen-borderJob rows, fields and the form box
--lumen-input-bgFields
--lumen-radiusCorner rounding
--lumen-fontFont
--lumen-max-widthWidth of the embed, 720px unless you set it

Limits

  • Ten applications an hour from one internet address, and five an hour from one email address. The career page and the embed share both limits.
  • One application per email address and job. A second one is answered "You have already applied for this job with this email address."
  • No screening questions, profile fields, sections or extra attachments in the embed. A job that requires them links to the career page.
  • No virus scan of CVs.
  • The CV bank is not in the embed. Link to it from your site instead.
SettingWhereDefaultApplies to
data-lumen-jobsThe placeholderRequiredOne embed
data-postThe placeholderNone: the listOne embed
data-langThe placeholderPage, then browser languageOne embed
data-headingThe placeholderShown. off hides "Open jobs"One embed
data-endpointThe placeholderhttps://api.lumenbase.ioOne embed

Troubleshooting

It says the career page does not exist

  1. Check data-lumen-jobs: it must be your workspace address, as in your career page link.
  2. Check that the workspace runs Bemanning, or Consulting with recruiting on.

Nothing shows at all

  1. Check that the script line is on the page, after or near the placeholder.
  2. If your site sends a Content Security Policy, allow the script and its requests. Your browser console names the blocked address.
Content Security Policy additions
script-src https://lumenbase.io;
connect-src https://api.lumenbase.io;

A job is missing

The list shows published jobs inside their publish dates that are listed on the career page. A job hidden from the list can still be shown alone with data-post. A new job can take a minute to appear.

Applications are refused

The message says why: a field to fix, a CV that is too large or not a PDF, DOC or DOCX, a closed job, a second application from the same address, or too many applications from one place. The same rules apply on the career page.

Script
https://lumenbase.io/lumen-jobs.js
Placeholder
<div data-lumen-jobs="your-address"></div>
Applications
Recruitment
Your own code instead
Jobs API and webhooks

Frequently asked questions

How do I show my Lumenbase jobs on my own website?

Paste two lines where the jobs should appear: a div with data-Lumo-jobs set to your workspace address, and the script https://lumenbase.io/Lumo-jobs.js. The workspace address is the part after /jobs/ in your career page link. No API key is needed.

Can candidates apply without leaving my site?

Yes. The embed shows the application form with name, email, phone, message, CV and consent, as the job asks. A job that requires screening questions, profile fields, sections or attachments links to the career page instead.

Which languages does the jobs embed speak?

English, Swedish, Ukrainian and Portuguese. It takes data-lang on the placeholder, else the language of your page, else the visitor's browser. Job titles and descriptions are shown as you wrote them.

Can I change the colours of the jobs embed?

It takes your career site's design system. To use other colours, set CSS variables such as --Lumo-accent and --Lumo-radius on .Lumo-jobs in your own stylesheet.

Was this article helpful?