Override Clerk interfaces with custom types

Clerk provides TypeScript interfaces that you can use to define custom types for your application. Custom types provide auto-complete and prevent TypeScript errors. You can define custom types for the following:

• ClerkAuthorization
• CustomJwtSessionClaims
• OrganizationPublicMetadata
• OrganizationInvitationPublicMetadata
• OrganizationMembershipPublicMetadata
• SignUpUnsafeMetadata
• UserPublicMetadata
• UserPrivateMetadata
• UserUnsafeMetadata

Example

To override an interface, you must define a global type, as shown in the following example:

1. In your application's root folder, add a types directory.
2. Inside of the types directory, add a globals.d.ts file.
3. Create the CustomJwtSessionClaims interface and declare it globally.
4. Add the custom claims to the CustomJwtSessionClaims interface.

export {}

declare global {
  interface CustomJwtSessionClaims {
    firstName?: string
    primaryEmail?: string
    metadata: {
      onboardingComplete?: boolean
    }
  }
}