Skip to main content
Version: v4

Overview

An Adapter in NextAuth.js connects your application to whatever database or backend system you want to use to store data for users, their accounts, sessions, etc. Adapters are optional, unless you need to persist user information in your own database, or you want to implement certain flows. The Email Provider requires an adapter to be able to save Verification Tokens.

tip

When using a database, you can still use JWT for session handling for fast access. See the session.jwt option. Read about the trade-offs of JWT in the FAQ.

We have a list of official adapters that are distributed as their own packages under the @next-auth/{name}-adapter namespace. Their source code is available in the organization repository at nextauthjs/adapters. Any issues regarding these adapters should be opened on that repository.

Custom Adapter#

If you have a database/backend that we don't officially support, you can create your own adapter. See the tutorial for creating a database Adapter for more information.

tip

If you would like to see a new adapter in the official repository, please open a PR and we will help you to get it merged. Tell us if you are interested in becoming a one of the maintainers of any of the official adapters.

Editor integration#

Adapters are strongly typed, and they rely on the single Adapter interface imported from next-auth/adapters.

When writing your own custom Adapter in plain JavaScript, note that you can use JSDoc to get helpful editor hints and auto-completion like so:

/** @return { import("next-auth/adapters").Adapter } */function MyAdapter() {  return {    // your adapter methods here  }}
note

This will work in code editors with a strong TypeScript integration like VSCode or WebStorm. It might not work if you're using more lightweight editors like VIM or Atom.