How it works
Email & Password Authentication
When users submit their credentials in a funnel, FunnelFox automatically handles Firebase user creation:- FunnelFox creates a Firebase user via Email/Password authentication
- By default, a secure random password is generated for the user
- If the same screen includes a Password input element, that value replaces the generated password
OAuth Authentication
OAuth providers enable seamless social authentication within your funnels:- Enable OAuth providers (e.g., Google or Apple) in Firebase and add OAuth buttons in the Visual Editor
- Users receive secure and seamless authentication experience
In this guide, we’ll show you how to set up the Google OAuth method. Optionally, you can also set up the Apple OAuth method. Just follow the tips in the Firebase popups once you select Apple as the provider.
Unified Identity (FUID)
Firebase UID becomes the canonical identifier across all integrated services:- The user’s Firebase UID (FUID) serves as their primary identifier
- When other integrations are enabled, FunnelFox forwards this ID automatically:
- Adapty receives it as CustomerUserID
- RevenueCat receives it as appUserID
Setup
Complete the Firebase integration by creating a Firebase project, configuring authentication methods, and connecting it to FunnelFox.1. Create Firebase Project
Start by setting up a new Firebase project in the Firebase console.- Go to the Firebase console and start creating a new Firebase project.
- Name your project
- Configure Google Analytics
- Click Create project
2. Configure Firebase Authentication
Enable Firebase Authentication to configure your preferred sign-in methods.- In your Firebase project, go to Build > Authentication

- Click Get started
3. Email/Password Method
The Email/Password method allows users to sign up using their email address and password.- Click Email/Password in the Native providers
- Toggle on Email/Password
- Click Save
- If you want to proceed with another sign-in method, click Add new provider

4. Google OAuth Method
Google OAuth provides seamless authentication using Google accounts.- Click Google in Additional providers
- Toggle on Google
- Enter your project details:
- Public-facing name: Displayed on emails that your users receive after creating an account with your app
- Support email: Presented to users when they are authenticating with Google
- Click Save

5. Google Console Setup
Configure Google Cloud console to enable OAuth authentication with your FunnelFox domain.You will need your full project URL for this step. Go to Settings > Domains in your FunnelFox project and copy your project URL, e.g.
https://demo-app.fnlfx.com
.- Open the project you’ve just created in the Google Cloud console

- Go to APIs & Services > Credentials from the Quick access section

- Open the web client just auto created by Google Service under OAuth 2.0 Client IDs

- Click Add URl under Authorized JavaScript origins and paste your full project URL

- Click Add URl under Authorized redirect URIs and paste your full project URL+
/__/auth/handler
. Your final URl will look likehttps://demo-app.fnlfx.com/__/auth/handler

- Click Save
6. Register Your App in Firebase
Register your web app in Firebase to obtain the configuration values needed for FunnelFox integration.- Go back to your Firebase project
- Click the settings gear icon at the top left and select Project settings

- Select the web icon under Your apps

- Add your app nickname
- Click Register app

7. Connect Firebase to FunnelFox
Complete the integration by adding your Firebase configuration to FunnelFox.- Go to Settings > Integrations > Firebase in FunnelFox
- Toggle on Firebase
- Copy the config values from Firebase project and paste them in FunnelFox using the following mapping:
Firebase Config Value | FunnelFox Field |
---|---|
apiKey | Firebase API Key |
authDomain | Firebase Auth Domain |
projectId | Firebase Project ID |
storageBucket | Firebase Storage Bucket |
messagingSenderId | Firebase Messaging Sender ID |
appId | Firebase App ID |
measurementId | Google Measurement ID |
- Click Save changes

You successfully integrated Firebase! Add the authentication methods you’ve set up to your funnels in the Visual Editor.
Add Authentication to Funnels
Once Firebase is configured, you can add authentication flows to your funnels using the Visual Editor. The following authentication methods correspond to the ones you’ve set up in Firebase.Email/Password Authentication
Enable users to sign in with their email address and custom password. To add Email/Password authentication to your funnel:- In the Visual Editor, add a screen for user registration
- Go to Add element > Inputs and add both Email and Password inputs
- Set the Custom ID to
firebase-password
for the Password input
By default, FunnelFox generates a random password when a user submits their email in the funnel. It’s important to add the Password input on the same screen to replace the previously generated password with the one provided

Google OAuth Authentication
Enable seamless authentication using Google accounts for a frictionless user experience. To add Google OAuth authentication to your funnel:- In the Visual Editor, add a screen for user registration or use the one you’ve already added for Email/Password
- Click Add element > Authentication and add OAuth button for Google
- Go to the Element tab of the OAuth button
- Under Actions, set up user navigation for cases when authentication succeeds or fails
