---
title: "AI Job Matching"
label: "AI job matching"
description: "How signed-in job seekers get a Job matches page of relevant jobs from their profile and resume, and how they opt into matching emails."
publishedAt: 2026-08-22
updatedAt: 2026-10-06
order: 8
status: "published"
faqs:
  - question: Do candidates see matches without an account?
    answer: "No. Matches require a verified candidate account. A signed-out visitor who opens /matches is redirected to sign in."
  - question: What if a candidate has no matches yet?
    answer: "The page stays empty until there is a usable profile signal. Uploading a resume completes the profile we use to match them with relevant jobs."
  - question: Is this the same as similar jobs on a listing?
    answer: "No. Similar jobs on a job page are related to that listing. Matches are personalized to the signed-in candidate."
  - question: Will a candidate be matched to on-site jobs in another city?
    answer: "Not unless they choose to. On-site and hybrid matches stay within the candidate's commute distance: 25 miles by default in the United States, United Kingdom, Liberia, and Myanmar, 50 km elsewhere. Turning on Open to relocate widens on-site matches to their whole country. Remote jobs are not affected by distance."
  - question: Are matching emails the same as job alerts?
    answer: "No. Job alerts match saved-search filters and do not require a profile. Matching emails send weekly jobs ranked from the candidate's profile. Someone can have both. They share your Email subscribers allowance."
---

AI job matching shows a signed-in job seeker a **Job matches** page of relevant jobs from their profile and resume. The public URL is `/matches`, next to `/saved-jobs`. The heading is personalized, for example "Ada's matches".

This is the same idea candidates already know from boards like Himalayas (`/jobs/matches`): a personal list, not a search they have to run.

## How it works

A signed-in candidate opens **Job matches** from their account menu. Cavuno ranks live jobs on the board from the candidate's profile — skills, roles, and the fields a resume upload fills in. Applied jobs are left out. See [how resume parsing connects to AI job matching](/blog/ai-resume-parsing-for-job-boards).

A signed-out visitor who lands on `/matches` is redirected to sign in, then returned here. After sign-up, the default copy explains that creating an account is how we match them with relevant jobs.

An empty list is a cold start, not an error. Drive a resume-upload prompt from the candidate's profile and resume status. Do not expect a hint field on the list itself.

You can edit the Job matches heading and empty copy in the [website builder](/docs/ai-website-builder), the same way you edit saved jobs.

## Location and commute distance

Matches respect where a candidate lives. In their profile, a candidate picks their location from the suggestions as they type, then answers **How far are you willing to commute?**

- The distance is shown in miles (mi) for candidates in the United States, United Kingdom, Liberia, and Myanmar, and in kilometres (km) everywhere else.
- If the candidate leaves it empty, the default is 25 mi in those countries and 50 km elsewhere.
- Any distance from 1 to 250 km (about 155 mi) is accepted.

How the location is used depends on the job and on what the candidate picked:

| Candidate | On-site and hybrid jobs | Remote jobs |
| --- | --- | --- |
| Picked a city or town | Jobs within their commute distance | Unchanged: matched on work permits |
| Picked a city or town, and **Open to relocate** is on | Jobs anywhere in their country, or in a country they hold a work permit for | Unchanged |
| Picked a region or country (for example "Texas") | Jobs anywhere in that country. The commute question is hidden, because a region has no single point to measure from | Unchanged |
| Typed a location without picking a suggestion | Jobs in the country named in the text, when one can be read from it | Unchanged |

Distance is measured from the job's own city or town. An on-site job listed only at region or country level is not matched by commute distance.

The country used for matching follows the picked place. For example, a candidate who picks Houston is matched as being in the United States, whatever the free-text label says.

The same rules apply everywhere matches appear: the Job matches page, weekly matching emails, and custom frontends that read matches through the API or SDK. Changing the location, distance, or relocation setting updates matches the next time they load.

## Matching emails

Signed-in candidates can also ask for a weekly email of those same ranked jobs. This is a separate opt-in from [job alerts](/docs/your-job-board/job-alerts). A missing preference means they are not subscribed. Existing candidates are not enrolled when the feature ships.

They see an unchecked checkbox during first-run resume onboarding, with default copy "Email me jobs that match my profile." Later resume imports do not show that checkbox again. They can turn the same preference on or off from **Settings** on your board.

Each digest includes up to ten jobs. The first successful email may include current open matches. Later emails include only matches published since the last successful digest. No email is sent when there are no qualifying jobs. Every message includes a settings link and one-click unsubscribe.

On the **Email subscribers** page, matching emails appear on the same email row as any saved-search alerts. The preference label is **Job matches**. Operator unsubscribe and resubscribe apply to both streams. See [Manage subscribers](/docs/job-alerts/manage-subscribers).

Matching emails and job alerts share your plan's **Email subscribers** allowance. A live job-alert stream and a live matching-email stream each count as one. Waitlisted people do not count. Subscribe and toggle always succeed at the cap: the person is waitlisted instead of rejected. Confirmation happens before waitlisting. When a live stream stops, the oldest waitlisted stream is promoted. There is no "you're in" email.

This opt-in is not marketing consent. Marketing consent stays on sign-up and the marketing-permissions API.

## Availability

- **Plan:** All paid plans. AI job matching is available on every paid plan.
- **Setting:** Settings, then Features, then "Job seeker profiles" (matches are part of candidate accounts; there is no separate switch).
- **Setup required:** None.

## Limitations

- Matches require a **verified candidate account**. There is no anonymous matches list.
- A thin profile returns fewer or no matches. Resume parsing is the fastest way to give the ranker something to work with.
- The list does not expose scores, weights, or why a job ranked where it did.
- Matching emails use the same ranker and the shared Email subscribers allowance. They are not job alerts.
- The commute distance only narrows on-site and hybrid jobs. It does not change which remote jobs a candidate sees.
- A candidate who typed a location without picking a suggestion is matched by country only, and only when the text names a country. Ask them to pick their location from the suggestions to get commute matching.

## Example

For example, a candidate creates an account, uploads a resume, and opens Job matches. Roles that fit their skills and title appear first. If they skip the resume, the page stays empty and asks them to upload one.

## Next steps

Enable and test [Job seeker profiles](/docs/your-job-board/candidate-profiles), then check [Saved jobs](/docs/your-job-board/saved-jobs) so the account menu has both destinations. Confirm matching emails from a test candidate's Settings and the [Job alerts](/docs/job-alerts/manage-subscribers) list. Custom frontends should use `board.me.recommendedJobs.list` and `board.me.notificationPreferences` — see [How to show job matches](/docs/sdk/cookbook/recommended-jobs).
