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.
- 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.
- Copy the embed code with your workspace address.
- Paste it where the jobs should appear on your site.
- 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.
<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 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>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.
<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 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.
| Field | Asked |
|---|---|
| First name, Email | Always, required |
| Last name | Always, optional |
| Phone | When the job asks for it, required or optional as the job says |
| Message | When the job asks for it, up to the job's character limit |
| CV | When the job asks for it. PDF, DOC or DOCX, up to 5 MB |
| Consent | Always. 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:
data-langon the placeholder, for exampledata-lang="sv".- The language of your page, from
<html lang="...">. - The visitor's browser languages.
- 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.
.lumen-jobs {
--lumen-accent: #0b5cad;
--lumen-radius: 4px;
--lumen-font: "Inter", sans-serif;
}| Variable | Used for |
|---|---|
--lumen-accent | Buttons, links, focus rings |
--lumen-accent-fg | Text on buttons |
--lumen-fg | Text |
--lumen-muted | The details line and hints |
--lumen-border | Job rows, fields and the form box |
--lumen-input-bg | Fields |
--lumen-radius | Corner rounding |
--lumen-font | Font |
--lumen-max-width | Width 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.
| Setting | Where | Default | Applies to |
|---|---|---|---|
| data-lumen-jobs | The placeholder | Required | One embed |
| data-post | The placeholder | None: the list | One embed |
| data-lang | The placeholder | Page, then browser language | One embed |
| data-heading | The placeholder | Shown. off hides "Open jobs" | One embed |
| data-endpoint | The placeholder | https://api.lumenbase.io | One embed |
Troubleshooting
It says the career page does not exist
- Check
data-lumen-jobs: it must be your workspace address, as in your career page link. - Check that the workspace runs Bemanning, or Consulting with recruiting on.
Nothing shows at all
- Check that the script line is on the page, after or near the placeholder.
- If your site sends a Content Security Policy, allow the script and its requests. Your browser console names the blocked address.
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?
