Plainform | Troubleshooting

Common authentication issues and their solutions.

Environment Variables

Sign-In/Sign-Up Issues

Session & Authentication State

API & Server Issues

Component Issues

Development vs Production

Performance Issues

Getting Help

If you're still experiencing issues:

Check Clerk Status: Visit status.clerk.com for service status
Clerk Documentation: See clerk.com/docs for detailed guides
Clerk Support: Contact support through Clerk Dashboard
Community: Join Clerk's Discord community for help

When reporting issues, include: - Error messages (full text) - Relevant code snippets - Clerk version (@clerk/nextjs version from package.json) - Next.js version - Steps to reproduce

Next Steps

Usage Examples

See working examples of authentication

API Reference

Complete API documentation

Architecture

Understand how Clerk works

Setup Guide

Configure Clerk from scratch

Troubleshooting

App won't start - Invalid environment variables

Clerk keys not working

Environment variables not updating

Redirect loop after sign-in

Sign-in form not appearing

OAuth providers not showing

Email verification not working

User appears signed out after refresh

useUser() returns undefined

auth() returns null in Server Component

Session expires too quickly

API route returns 401 Unauthorized

Middleware blocking routes unexpectedly

Server Actions not working with auth

UserButton not rendering

Custom sign-in form not working

Styling not applying to Clerk components

Works in development but not production

Webhooks not working in production

Slow authentication checks

Large bundle size from Clerk

Usage Examples

API Reference

Architecture

Setup Guide

On this page