joblabs-embed
v1.0.0
Published
Embed JobLabs UK calculators (take-home pay, redundancy, notice period, career change) into any website with one line of code.
Maintainers
Readme
joblabs-embed
Embed JobLabs UK calculators into any website with one line of code.
A 1.5 kb embed helper for the free UK calculators built by JobLabs.ai — the recruiter-built UK careers site. Use any of the calculators inside your own blog post, employer benefits page, accountant's site, or salary tool, with auto-resize, accessible defaults and a clean iframe.
Available calculators
| Widget key | What it does | Live page |
|---|---|---|
| take-home-pay | UK take-home pay 2026/27 — income tax, NI, pension, student loan, salary sacrifice | free-tools/uk-take-home-pay-calculator/ |
| redundancy | UK statutory redundancy pay — age × service × weekly cap | free-tools/uk-redundancy-pay-calculator/ |
| notice-period | UK notice period — statutory minimum + contractual + last-day calc | free-tools/uk-notice-period-calculator/ |
| career-change | Career Change Difficulty Score — 6-factor 0-100 scale | free-tools/career-change-difficulty-score/ |
All calculators are free, privacy-first (no signup, no tracking, no data sent anywhere), and kept up to date with UK statutory rates each tax year.
Install
npm install joblabs-embedOr use the auto-script via CDN — no install needed:
<script src="https://unpkg.com/joblabs-embed/src/auto.js" defer></script>Usage — programmatic
import { embed } from 'joblabs-embed';
embed({
target: '#my-calculator-slot',
widget: 'take-home-pay',
});Make sure the target element exists in your HTML:
<div id="my-calculator-slot"></div>Options
| Option | Type | Default | Description |
|---|---|---|---|
| target | string | Element | required | CSS selector or DOM element to mount into |
| widget | string | required | One of take-home-pay, redundancy, notice-period, career-change |
| minHeight | number | varies by widget | Override iframe height in pixels |
| title | string | widget default | Custom iframe title (a11y) |
Usage — auto-init via data attribute
The simplest way. Drop one script tag and one div per widget:
<!-- in <head> -->
<script src="https://unpkg.com/joblabs-embed/src/auto.js" defer></script>
<!-- anywhere in <body> -->
<div data-joblabs-widget="take-home-pay"></div>
<div data-joblabs-widget="redundancy"></div>Optional per-widget height override:
<div data-joblabs-widget="take-home-pay" data-min-height="800"></div>Why these calculators
Built by Alex Morgan — a 12-year UK recruiter who's reviewed 40,000+ CVs and placed candidates from grad to C-level. Each calculator implements UK statutory rules with line-by-line citations to gov.uk, HMRC and ACAS sources. Updated every UK tax year (April).
Open-source companion data: every UK statutory rate cited is published as a CC BY 4.0 dataset at joblabs.ai/data/ — JSON, CSV and Markdown formats with full source attribution.
Attribution
You don't have to credit JobLabs visibly — the iframe footer already includes a small "Powered by JobLabs" link. But if you do want to add a visible byline, we'd appreciate Calculator by [JobLabs.ai](https://joblabs.ai/) somewhere on your page.
If your blog post or article uses the calculator output to make a point, citing the underlying data at joblabs.ai/data/ is welcome.
Browser support
Modern browsers (Chrome, Firefox, Safari, Edge — last 2 major versions). The package is plain ES modules with no dependencies. The iframe content runs on Astro 5 and supports all the same browsers.
Licence
MIT — do whatever you want, including using on commercial websites. The iframe content is also free to embed under the same terms.
Changelog
- 1.0.0 — Initial release. 4 widgets: take-home-pay, redundancy, notice-period, career-change.
Links
- 🌐 JobLabs.ai — UK careers + AI insights, written by a recruiter
- 📊 Open datasets — UK statutory rates 2026/27 as JSON/CSV (CC BY 4.0)
- 🛠️ All free tools — calculators, CV checkers, decision tools
- 📚 UK Rights & Guides — 200+ statutory and tactical guides
- 📧 Contact: [email protected]
- 🐛 Issues: github.com/Careerflow2025/JOBLABS/issues
Built by Alex Morgan at JobLabs.ai.
