docs(auth): clarify audit logs storage options and configuration (#48852)

## Summary

- Clarify that external log storage is the default
- Explain that Postgres database storage is optional
- Fix grammar and typos
- Improve admonition messaging to be more actionable
- Simplify toggle step wording for clarity

Slack thread with team-auth:
https://supabase.slack.com/archives/C022071RB2L/p1785945149999009

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **Documentation**
* Clarified that audit logs are stored in external log storage by
default.
  * Documented optional database storage in `auth.audit_log_entries`.
* Added instructions for enabling or disabling database storage with the
“Write audit logs to the database” toggle.
* Noted that enabling database storage incurs additional database
storage costs.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
This commit is contained in:
Gabriel Claudino authored and GitHub committed 2026-08-07 17:58:30 +01:00
1 parent 124ff77ad0
commit 18c26bf933
1 file changed
+6 -12
+6 -12
View File
@@ -18,25 +18,19 @@ Supabase auth audit logs automatically capture all authentication events includi
## Storage options
By default, audit logs are stored in two places:
Audit logs are stored in:
1. **Your project's Postgres database** - Stored in the `auth.audit_log_entries` table, searchable via SQL but uses database storage
2. **External log storage** - Cost-efficient storage accessible through the dashboard
- **External log storage** - Cost-efficient storage accessible through the dashboard
- **Postgres database** (optional) - Stored in the `auth.audit_log_entries` table, searchable via SQL, but uses additional database storage
You can disable Postgres storage to reduce database storage costs while keeping the external log storage.
You can enable or disable Postgres database storage to optimize your costs.
### Configuring audit log storage
1. Navigate to your project’s dashboard
2. Go to **Authentication**
3. Find the **Audit Logs** under **Configuration** section
4. Toggle on "Disable writing auth audit logs to project database" to disable database storage
<Admonition type="note">
Disabling Postgres storage reduces your database storage costs. Audit logs will still be available through the dashboard.
</Admonition>
3. Find the **Audit Logs** under the **Configuration** section
4. Toggle "Write audit logs to the database" on to enable or off to disable database storage
## Log format