# Qualifications

> Qualification types (certifications, licences, skills) with a validity in months and optional evidence, requirements naming who must hold them (a role, a team, a job title, an asset kind, a segment or one holder), holdings of members, companies and assets that expire, a gap report, the holders qualified on a date, expiry notifications, and holdings granted from course certificates.

- Category: People
- Module: `qualifications`
- Modes: `managed`, `custom`
- Docs: https://bettersupabase.com/docs/blocks/qualifications
- Page: https://bettersupabase.com/blocks/qualifications

## Install

```bash
npx better-supabase add qualifications
```

The command also installs `updated-at`, `memberships`, `permissions`, `subjects`.

## Configure

Add the block to `better-supabase.config.ts`:

```ts
import { defineConfig } from "better-supabase/config";

export default defineConfig({
  blocks: {
    // Required by qualifications; add installs them too.
    "updated-at": {},
    memberships: {},
    permissions: {},
    subjects: {},
    // Modes: "managed", "custom". The default is "managed".
    qualifications: { mode: "managed" },
  },
});
```

## Client

The block has no React entry yet. Its server-side TypeScript is in `better-supabase/blocks/qualifications`.

## Events

- `qualification.expired`
- `qualification.expiry_warned`
- `qualification.granted`
- `qualification.revoked`
- `qualification_type.archived`
- `qualification_type.created`
- `qualification_type.updated`

## Related blocks

Requires: [memberships](https://bettersupabase.com/blocks/memberships.md), [permissions](https://bettersupabase.com/blocks/permissions.md), [subjects](https://bettersupabase.com/blocks/subjects.md)

Works with: [courses](https://bettersupabase.com/blocks/courses.md), [employees](https://bettersupabase.com/blocks/employees.md), [teams](https://bettersupabase.com/blocks/teams.md), [contacts](https://bettersupabase.com/blocks/contacts.md), [assets](https://bettersupabase.com/blocks/assets.md), [segments](https://bettersupabase.com/blocks/segments.md), [attachments](https://bettersupabase.com/blocks/attachments.md), [notifications](https://bettersupabase.com/blocks/notifications.md), [outbox](https://bettersupabase.com/blocks/outbox.md), [audit](https://bettersupabase.com/blocks/audit.md)

## Recipes

- [Qualification matrix](https://bettersupabase.com/recipes/qualification-matrix.md): A table of the members who lack a required qualification, hold an expired one or will lose one soon.
- [My qualifications](https://bettersupabase.com/recipes/my-qualifications.md): The signed-in member's certificates and licences with their expiry, and the required ones they still lack.