BuildUtilities

JWT Claims Cheat Sheet

JWT claims are just keys in the payload object. The IANA registry standardizes the short ones, stick to them where they apply and use custom claims for everything else.

Registered claims (RFC 7519)

issIssuer, who created and signed the token (URL, usually)
subSubject, who/what the token is about (user ID)
audAudience, who the token is for (your API)
expExpiration. Unix timestamp, after which the token is invalid
nbfNot Before. Unix timestamp, before which the token is invalid
iatIssued At. Unix timestamp when the token was created
jtiJWT ID, unique identifier for this token, useful for revocation lists

OIDC profile claims

emailUser's email address
email_verifiedWhether the email is verified (boolean)
nameFull display name
given_nameFirst name
family_nameLast name
pictureURL to profile picture
preferred_usernameUsername
localeBCP-47 locale tag (e.g. en-US)

Common header claims

algSigning algorithm. HS256, RS256, ES256, etc.
typToken type, usually 'JWT'
kidKey ID, which key from the JWKS was used to sign

Related tools

More references

Tip Jar