Manage Categories, Skills, and Markets

Every job on your board is tagged with categories and skills. Every company is tagged with markets. These tags power your filters, category and skill pages, job alerts, and search.

In Settings → Taxonomy, you decide who manages each list and how it's organized.

Choose who manages each list

1. Go to Settings → Taxonomy. The table shows Categories, Skills, and Markets, each marked Managed by AI or Managed by you.
2. Open a row's ⋯ menu and choose Settings.
3. Choose who manages the list:
   • Let AI manage my list: the recommended option, and what most boards use. AI adds new terms as jobs need them.
   • Manage my list myself: AI tags jobs only from your list. New terms and merges are suggested on the Suggested tab and change your list only when you approve them.

Choose Manage my list myself when your list is fixed, such as a set of programs of study, member groups, or a category structure you built for SEO.

AI tags every job in both modes. The setting decides only who adds, merges, and organizes the terms.

Tell AI what your list describes

When you manage a list yourself, its settings ask what the list describes. Each list has an answer that most boards use:

• Categories: choose The type of job.
• Skills: choose Skills the job requires.
• Markets: choose The company's industry.

If your list describes something different, choose Something else and describe it in one sentence, such as "Our school's programs of study" or "Certifications our members can earn".

AI uses your answer to pick the right terms for each job. Change it whenever your list changes.

Organize your list

Choose Manage on a row you manage to open the list. All shows every term with its live jobs, busiest first.

• Add: add one term. For categories, choose Parent or Child, and pick the parent for a child.
• Import: paste one term per line, or upload a CSV. Nest categories with Parent > Child > Grandchild.
• Rename: the old address redirects to the new one.
• Move to…: put a category under another, or choose None (top level). Categories nest up to 3 levels.
• Merge…: fold one or more terms into another. The dialog shows how many jobs move. A merged term's page redirects to the page of the term it merged into.
• Delete: the dialog shows how many jobs lose the term. A deleted category's subcategories move to the top level. Choose Merge instead to keep the jobs tagged.

Select several rows to move, merge, or delete them together.

Review suggestions

The Suggested tab lists what AI wants to change on a list you manage.

No match: a tag that matches nothing on your list.

• Accept: adds it as a new term.
• Mark as alias…: tags it as one of your terms from now on.
• Reject: ignores it.

Duplicate: two terms that look like they mean the same thing, when Cavuno spots them.

• Accept: merges them.
• Reject: keeps them separate.
• ⋯ menu: choose Reverse direction or Merge into a different term….

Click a row to see example jobs and live job counts. For duplicates on a board connected to Google Search Console, you also see each page's Google impressions over the last 28 days, so you can choose which page to keep.

Select several rows to accept or reject them together.

Jobs that waited on a suggestion are tagged as soon as you answer it.

View rules and undo merges

On the list page, open the ⋯ menu and choose View rules. It shows every answer and who made it: aliases (Same as), merges, ignored tags, and pairs kept separate.

• Remove: stops a rule applying to new tags. Jobs already tagged keep their tags.
• Undo: undoes a merge. You have 30 days, from here or from the toast right after the merge. The merge dialog tells you up front when a merge moves too many jobs to undo.

Re-tag existing jobs

Re-tag after you change your list or its description.

1. On the list page, open the ⋯ menu.
2. Choose Update tags on all jobs. For markets, choose Update tags on all companies.

AI checks your live jobs against your current list and updates their tags, up to your plan's live-job limit. For markets, it adds markets from your list to companies with live jobs and doesn't remove existing ones. Progress shows next to the list in Settings → Taxonomy.

• How often: once every 24 hours for each list.
• Hand-set tags: jobs whose categories or skills you set by hand on the job keep them.
• Public pages: tags on public pages can change, so review a few category pages afterwards.

Parent category pages

• Jobs: a parent category's page also shows its subcategories' jobs.
• Job count: the parent's job count includes them.
• Parents with jobs only in subcategories: they still get a page, appear in category lists, and are listed in your sitemap like any other category page.

Do it through the API

Every setting and review step on this page also works through the Cavuno API and MCP server, so an AI assistant can manage your taxonomy for you:

• GET / PATCH /v1/taxonomies/settings: who manages each list (unmatchedTagMode: create for Let AI manage my list, ask for Manage my list myself) and what it describes (listDescription)
• GET /v1/taxonomies/suggestions and POST /v1/taxonomies/suggestions/{id}/answer
• GET /v1/taxonomies/rules and DELETE /v1/taxonomies/rules/{id}
• GET /v1/taxonomies/{categories|skills}/{id}/merge-preview, POST .../merge, and POST /v1/taxonomies/{categories|skills}/merges/{mergeId}/undo
• GET / POST /v1/taxonomies/retag

Verify your setup

1. Switch a list to Manage my list myself and describe it.
2. Choose Update tags on all jobs and wait for the run to finish.
3. Open a few jobs on your board and check their tags come from your list.
4. Check Suggested for tags your list is missing.

Next steps

• Change a single job's categories and skills
• How category and location pages work
• Company markets