revenuecat-identify-user

Sync app authentication users with RevenueCat identity by replacing the default anonymous appUserID with a stable appUserID via logIn after your auth system confirms the session. This ensures entitlements and purchase history map to the correct person.

Purchases made while anonymous are preserved when transitioning to an identified user. The logIn method switches from the $RCAnonymousID placeholder to your stable appUserID, linking the existing purchase history and entitlements to the correct identity.

RevenueCat logIn and logOut work across iOS, Android, Kotlin Multiplatform, Flutter, and React Native. The platform is detected from project files, and platform-specific wiring patterns are applied for correct identity transitions.

Handle account switching by calling logOut for identified users first, then logIn for the next user. This ensures correct identity transitions and prevents entitlement mapping errors during multi-account switching scenarios.

Avoid using email addresses, phone numbers, or sequential IDs as your RevenueCat appUserID. These violate guardrails and can cause identity mapping issues. Instead, use a stable internal identifier from your authentication system.

Calling logOut while anonymous is unnecessary and can cause identity issues. LogOut is designed for identified users to properly transition between accounts. Anonymous users should use logIn directly to switch to a stable appUserID.