# Acknowledgements

> Members confirm they read the current version of a record: assignments to a member, a team or a role, a due date per assignment, a click or a completed signature, and a reminder once a version is overdue.

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

## Install

```bash
npx better-supabase add acknowledgements
```

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

## Configure

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

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

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

## Client

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

## Events

- `acknowledgement.created`
- `acknowledgement.reminded`
- `acknowledgement_assignment.created`
- `acknowledgement_assignment.deleted`

## Related blocks

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

Works with: [subjects](https://bettersupabase.com/blocks/subjects.md), [teams](https://bettersupabase.com/blocks/teams.md), [signatures](https://bettersupabase.com/blocks/signatures.md), [notifications](https://bettersupabase.com/blocks/notifications.md), [outbox](https://bettersupabase.com/blocks/outbox.md), [audit](https://bettersupabase.com/blocks/audit.md)

## Recipes

- [Acknowledgement inbox](https://bettersupabase.com/recipes/acknowledgement-inbox.md): The records a member is asked to read, soonest due first, with the due date and a button that acknowledges the version they read.
