Course contentsShow
← Web Development
Lesson 1592 of 2,98229. Web Authentication PatternsFree lesson

Token Payload Size and Performance

Keeping JWT payloads small to minimize request overhead and bandwidth usage.

Token Payload Size and Performance

You'll learn why keeping your JWT payloads lean directly impacts your application's speed and bandwidth costs.

The Hidden Cost of Heavy Tokens

Every JWT you send travels with every single API request. If your token's payload is bloated with unnecessary data, you're essentially forcing your user to re-upload that data dozens or hundreds of times per session. It's like stuffing a heavy backpack before running a marathon—you'll finish, but much slower and more exhausted.

Why Size Matters

JWTs are base64-encoded strings. A typical minimal token might be 200-300 bytes, but carelessly adding claims can balloon it to 1KB or more. Consider:

// Lean payload (~250 bytes encoded)
{
  "sub": "user123",
  "exp": 1735689600,
  "role": "admin"
}

// Bloated payload (~1KB+ encoded)
{
  "sub": "user123",
  "exp": 1735689600,
  "role": "admin",
  "email": "user@example.com",
  "firstName": "John",
  "lastName": "Doe",
  "preferences": {...},
  "permissions": ["read", "write", "delete", "admin", ...]
}

Since this token flies in the Authorization header with every fetch request, a bloated token means:

  • More bandwidth consumed (costly on mobile networks)
  • Slower request transmission (especially on poor connections)
  • Increased server processing (parsing larger headers)

What to Include vs Exclude

Include only authentication essentials: user ID (sub), expiration (exp), and minimal role/scope data. Keep detailed user profiles, preferences, or permissions lists in your database—fetch them once after login, not with every request.

Key Takeaway: Keep JWT payloads under ~500 bytes by storing only essential authentication data; fetch detailed user information separately to avoid repeating large data transfers with every API call.