# Bulk actions

> One action over many rows: up to a limit in one call with a result per row, and larger sets as a background run on the jobs queue that runs as the user who started it.

- Category: Work management
- Module: `bulk-actions`
- Modes: `managed`, `adopt`, `custom`
- Docs: https://bettersupabase.com/docs/blocks/bulk-actions
- Page: https://bettersupabase.com/blocks/bulk-actions

## Install

```bash
npx better-supabase add bulk-actions
```

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

## Configure

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

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

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

## Client

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

## Events

- `bulk_run.completed`

## Related blocks

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

Works with: [queue](https://bettersupabase.com/blocks/queue.md), [outbox](https://bettersupabase.com/blocks/outbox.md), [tags](https://bettersupabase.com/blocks/tags.md), [state-machine](https://bettersupabase.com/blocks/state-machine.md), [relations](https://bettersupabase.com/blocks/relations.md), [trash](https://bettersupabase.com/blocks/trash.md), [collections](https://bettersupabase.com/blocks/collections.md)

## Recipes

- [Bulk action bar](https://bettersupabase.com/recipes/bulk-action-bar.md): A bar over a selection of rows that runs an action on all of them and reports failures.