Skip to content
Draft oJobPub 1.0.0-draft.1 is open for feedback

Publish jobs on your own website. Let the whole web find them.

oJobPub is a free, open format for job openings. Add one small file to your website, and job boards, search engines and apps can list your jobs, while applications still come straight to you.

Read the documentation See how it works
application/json
{
  "version": "1.0",
  "lastUpdated": "2026-09-01T08:00:00Z",
  "employer": {
    "name": "Your Company",
    "location": { "city": "Bern", "country": "CH" },
    "url": "https://your-company.com"
  },
  "jobs": [
    {
      "title": "Carpenter",
      "language": "en",
      "publishedAt": "2026-09-01",
      "jobType": "permanent",
      "locations": [{ "city": "Bern", "country": "CH" }],
      "url": "https://your-company.com/jobs/carpenter"
    }
  ]
}
Type your domain to see where your job file would live.

Our mission

Make publishing and finding job openings free, simple and convenient, on the employer's own website, in one open format anyone can read.

  • A carpenter measuring timber on a building site
  • Staff preparing orders behind a café counter
  • A potter shaping clay at the wheel in a workshop
  • A team working together on laptops at a long table
From the workshop to the café to the office: every workplace has openings, and every employer should be able to publish them without paying a portal.

How it works

Four steps. No account, no listing fees, no middleman.

  1. Keep your jobs on your website

    Post your openings where they already belong: on your own site, with your own application process.

  2. Add an ojobpub.json file

    Describe your openings in one JSON file at /.well-known/ojobpub.json. Write it by hand, or create it with Publisher, our free service. Publisher is open source under the Apache 2.0 license, so you can also host it yourself.

  3. Add your website to SourceTracker

    Enter your domain once at sources.letsemploy.org. Our indexer visits it every day, downloads your ojobpub.json and checks that it is valid.

  4. Get found

    Valid job data goes into a free daily export and an API. Job boards, search engines and apps use them to make your jobs searchable. See it in action at jobs.letsemploy.org, our free job search. Every listing links back to you.

Our goals

What changes when job openings are published in the open.

Jobs get found

Structured data and an open standard let many platforms and job boards pick up your openings. You reach a broader audience without posting anything twice.

Use your website

Publish job openings on your own website and keep full control over your listings and your application process.

Reduce costs

No listing fees and no copying the same job into ten portals. Open standards save you time and money.

Open standard

oJobPub is open and free to implement, so search engines and job platforms can index your listings reliably.

The format

oJobPub is a small, readable JSON document with a public JSON Schema. The specification is a draft (version 1.0.0-draft.1), and feedback is welcome.

  • Lives at https://<your-domain>/.well-known/ojobpub.json
  • Served over HTTPS as application/json
  • Redirects are allowed, so the file can be hosted anywhere
  • The schema is licensed CC0, free for any use
Required for every job
titlelanguagepublishedAtjobTypelocationsurl
Optional
descriptioncategoryreferenceIdapplyBeforestartDateendDateworkTypeworkLoadexperienceLevelsalarytags
Read the specification JSON Schema
example.com/.well-known/ojobpub.json 
{
  "version": "1.0",
  "lastUpdated": "2025-09-13T12:00:00Z",
  "employer": {
    "name": "Acme Corp",
    "location": { "city": "New York", "country": "US" },
    "industry": "Software",
    "url": "https://example.com"
  },
  "jobs": [
    {
      "title": "Software Engineer",
      "language": "en",
      "publishedAt": "2025-08-30",
      "applyBefore": "2026-12-31",
      "category": "Engineering",
      "referenceId": "SE-2023-001",
      "description": "Develop and maintain software applications.",
      "jobType": "permanent",
      "workType": "hybrid",
      "experienceLevel": "mid",
      "workLoad": { "minPercentage": 80, "maxPercentage": 100 },
      "tags": ["python", "flask", "backend"],
      "locations": [
        { "city": "New York", "country": "US" },
        { "city": "San Francisco", "country": "US" }
      ],
      "salary": { "min": 70000, "max": 120000, "currency": "USD", "interval": "yearly" },
      "url": "https://example.com/job/1"
    }
  ]
}

Who it's for

Employers

Publish once, on your own terms. No listing fees, no lock-in, no copying the same job into ten portals.

Job seekers

Find current openings with the details that matter, like workload and salary, and apply directly with the employer.

Job boards and search engines

Download every validated job in one daily export, or query the API. One format, straight from the source, no scraping.

Developers

Build tools, plugins and integrations on an open, CC0-licensed schema. Contributions are welcome on GitHub.

Latest news

All news

1 min read

A new website, in nine languages

letsemploy.org has a new look, explains the whole path from your website to a job search, and now speaks nine languages.

Questions and answers

Didn’t find your answer? Ask us on GitHub.

Is it really free?
Yes. oJobPub is an open standard, and Let’s Employ is a non-profit, open source initiative. There are no fees for publishing or for reading job data.
Do I need a developer?
Not necessarily. The file is plain JSON: write it in any text editor and upload it to your website, or let Publisher, our free service, create it for you. Publisher is open source software under the Apache 2.0 license, so you can also run it on your own server.
How is this different from a job board?
A job board hosts your listing on its own site. With oJobPub, the listing stays on your website and job boards read it from there. You can keep using job boards too; they simply get your data from the source.
How do job boards get my jobs?
Add your domain to SourceTracker, our free indexer. It visits every registered domain daily, downloads the ojobpub.json and validates it. Jobs from healthy domains are published in a daily export and through an API that anyone can use. If your file stays unreachable or invalid, the domain is marked unhealthy and can eventually be removed. Learn more about SourceTracker.
Does it replace schema.org JobPosting?
No, the two work well together. JobPosting markup describes a single job page for search engines. An ojobpub.json file lists all your openings in one place, so anyone can find them without crawling your site.
Is the standard finished?
Not yet. The specification is a public draft (version 1.0.0-draft.1). Now is a good time to try it and share feedback on GitHub.
Who is behind Let's Employ?
An independent, non-profit initiative based in Switzerland. The specification, schema and tools are developed in the open on GitHub.

Publish your first ojobpub.json

Create the file with Publisher or by hand, then add your website to SourceTracker so your jobs are indexed every day.

Create your job file Add your website

Read the documentation