github-starred/better-auth
2
0
Fork 0
mirror of https://github.com/better-auth/better-auth.git synced 2026-10-25 10:13:54 -05:00
Code Issues 2.5k Packages Projects Releases 112 Wiki Activity

docs: update faq.mdx (#7309)

Browse Source
This commit is contained in:
Alex Yang
2026-01-12 15:27:35 -08:00
committed by GitHub
parent 7bf47e7284
commit bb68f8e78f
1 changed files with 7 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/content/docs/reference/faq.mdx
+7 -13
View File
@@ -6,7 +6,7 @@ description: Frequently asked questions about Better Auth.
This page contains frequently asked questions, common issues, and other helpful information about Better Auth.
<Accordions>
<Accordion title="Auth client not working">
<Accordion id="auth-client-not-working" title="Auth client not working">
When encountering `createAuthClient` related errors, make sure to have the correct import path as it varies based on environment.
If you're using the auth client on react front-end, you'll need to import it from `/react`:
@@ -23,7 +23,7 @@ import { createAuthClient } from "better-auth/client";
</Accordion>
<Accordion title="getSession not working">
<Accordion id="getsession-not-working" title="getSession not working">
If you try to call `authClient.getSession` on a server environment (e.g, a Next.js server component), it doesn't work since it can't access the cookies. You can use the `auth.api.getSession` instead and pass the request headers to it.
```tsx title="server.tsx"
@@ -49,13 +49,13 @@ const session = await authClient.getSession({
```
</Accordion>
<Accordion title="Adding custom fields to the users table">
<Accordion id="adding-custom-fields-to-the-users-table" title="Adding custom fields to the users table">
Better Auth provides a type-safe way to extend the user and session schemas, take a look at our docs on <Link href="/docs/concepts/database#extending-core-schema">extending core schema</Link>.
</Accordion>
<Accordion title="Difference between getSession and useSession">
<Accordion id="difference-between-getsession-and-usesession" title="Difference between getSession and useSession">
Both `useSession` and `getSession` instances are used fundamentally different based on the situation.
`useSession` is a hook, meaning it can trigger re-renders whenever session data changes.
@@ -78,7 +78,7 @@ For all other situations where you shouldn't use `useSession`, is when you shoul
</Callout>
</Accordion>
<Accordion title="Common TypeScript Errors">
<Accordion id="common-typescript-errors" title="Common TypeScript Errors">
If you're facing typescript errors, make sure your tsconfig has `strict` set to `true`:
```json title="tsconfig.json"
{
@@ -99,21 +99,15 @@ if you can't set strict to true, you can enable strictNullChecks:
You can learn more in our <Link href="/docs/concepts/typescript#typescript-config">TypeScript docs</Link>.
</Accordion>
<Accordion title="Can I remove `name`, `image`, or `email` fields from the user table?">
<Accordion id="can-i-remove-name-image-or-email-fields-from-the-user-table" title="Can I remove `name`, `image`, or `email` fields from the user table?">
At this time, you can't remove the `name`, `image`, or `email` fields from the user table.
We do plan to have more customizability in the future in this regard, but for now, you can't remove these fields.
</Accordion>
<Accordion title="Better Auth was already imported / `runWithRequestState` Error / Dual Module Hazard Issue">
<Accordion id="dual-module-hazard-issue" title="Dual Module Hazard Issue">
If you're encountering errors like:
```
Better Auth was already imported. This breaks async local storage instance and will lead to issues!
```
Or like:
```
No request state found. Please make sure you are calling this function within a `runWithRequestState` callback.
```