Auth Audit Logs

Auth audit logs provide comprehensive tracking of authentication events in your Supabase project. Audit logs are automatically captured for all authentication events and help you monitor user authentication activities, detect suspicious behavior, and maintain compliance with security requirements.

What gets logged#

Supabase auth audit logs automatically capture all authentication events including:

• User signups and logins
• Password changes and resets
• Email verification events
• Token refresh and logout events

Storage options#

Audit logs are stored in:

• 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 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 the Configuration section
4. Toggle "Write audit logs to the database" on to enable or off to disable database storage

Log format#

Audit logs contain detailed information about each authentication event:

1
{
2
  "timestamp": "2025-08-01T10:30:00Z",
3
  "user_id": "uuid",
4
  "action": "user_signedup",
5
  "ip_address": "192.168.1.1",
6
  "user_agent": "Mozilla/5.0...",
7
  "metadata": {
8
    "provider": "email"
9
  }
10
}

Log actions reference#

Limitations#

• There may be a short delay before logs appear
• Query capabilities are limited to the dashboard interface