Skip to content

Clarify Inactivity Timeout and Maximum lifetime defaults and plan availability #2335

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Jun 24, 2025
Merged

Clarify Inactivity Timeout and Maximum lifetime defaults and plan availability #2335

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ee03ddf
Add not free callout + clarify default setting
SarahSoutoul Jun 24, 2025
70d45c0
Add clarification on maximum lifetime
SarahSoutoul Jun 24, 2025
a3549bf
Final refinements
SarahSoutoul Jun 24, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions docs/authentication/configuration/session-options.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,11 +18,13 @@ Fortunately, with Clerk, you have the ability to fully control the lifetime of y

### Inactivity timeout

<Include src="_partials/feature-not-free-callout" />

Inactivity timeout is the duration after which a session will expire and the user will have to sign in again, if they haven't been active on your site.

A user is considered inactive when the application is closed, or when the app stops refreshing the token.

By default, the inactivity timeout is set to 7 days. You can set a custom inactivity timeout by following these steps:
By default, this setting is disabled. You can enable it and configure a custom inactivity timeout by following these steps:

1. In the Clerk Dashboard, navigate to the [**Sessions**](https://dashboard.clerk.com/last-active?path=sessions) page.
1. Toggle on **Inactivity timeout**.
Expand All @@ -33,9 +35,9 @@ By default, the inactivity timeout is set to 7 days. You can set a custom inacti

### Maximum lifetime

The duration after which a session will expire and the user will have to sign in again, regardless of their activity on your site.
Maximum lifetime is the duration after which a session will expire and the user will have to sign in again, regardless of their activity on your site.

By default, this setting is enabled with a default value of 7 days for all newly created instances. To find this setting and change the value:
By default, this setting is enabled with a default value of 7 days for all newly created instances. Setting a custom maximum lifetime requires a [paid plan](/pricing){{ target: '_blank' }} for production use, but it's available in development mode so that you can try out what works for you. To find this setting and change the value:

1. In the Clerk Dashboard, navigate to the [**Sessions**](https://dashboard.clerk.com/last-active?path=sessions) page.
1. Toggle on **Maximum lifetime**.
Expand Down