Plugin Options ⚙️

The plugin takes a single options object. Everything Better Auth knows about (plugins, social providers, email flows, sessions, ...) goes inside the nested betterAuth key.

betterAuthPlugin({
  betterAuth: {
    appName: 'My App',
    plugins: [
      // your additional Better Auth plugins
    ],
    socialProviders: {
      // github, google, ...
    },
    // any other BetterAuthOptions
  },
  extendsCollections: {
    // per-collection overrides
  },
  logs: 'info',
})

For the full type, see Plugin Options.

Better Auth Options 🔧

The betterAuth object accepts the native Better Auth options. One exception: the database field is omitted because the plugin wires the Payload adapter automatically.

Default Better Auth plugins

The plugin pre-registers a handful of Better Auth plugins so that the admin UI works out of the box (source: src/better-auth/plugins.server.ts):

Collection Extensions 📦

extendsCollections lets you patch the auto-generated Better Auth collections (user, session, account, verification, plus any plugin-added ones). See Collections for the full reference.

Logging

betterAuthPlugin({
  logs: 'debug', // false | 'fatal' | 'error' | 'warn' | 'info' | 'debug' | 'trace'
})

Defaults to 'info'. Pass false to silence the plugin entirely.