# Tenant memberships and permission helper

> Memberships with roles, member_organization_ids() and has_organization_role() for RLS policies, and membership_claims() for the access token hook. Adopt an existing memberships table through blocks.memberships.

- Category: Tenancy & accounts
- Module: `memberships`
- Modes: `managed`, `adopt`, `custom`
- Docs: https://bettersupabase.com/docs/blocks/memberships
- Page: https://bettersupabase.com/blocks/memberships

## Install

```bash
npx better-supabase add memberships
```

The command also installs `updated-at`.

## Configure

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

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

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

## Client

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

## Related blocks

Requires: [updated-at](https://bettersupabase.com/blocks/updated-at.md)

Works with: [permissions](https://bettersupabase.com/blocks/permissions.md), [invitations](https://bettersupabase.com/blocks/invitations.md), [organizations](https://bettersupabase.com/blocks/organizations.md)