Identity verification

Identity verification allows you to associate signed-in users with individual feedback responses. In the responses, you will be able to view their name and email. If the snippet is missing, the users appear as “Anonymous”.

Note, this does not change the visitor’s experience. The modal and chat functionality is the same for both verified and anonymous users.

How it works

Add this snippet before your Franko embed script:

<script>
// Replace the placeholder values with your own user data
window.FrankoUser = {
  user_id: YOUR_CURRENT_USER_ID, // e.g. user.id, usually from your auth provider
  user_metadata: {
    name: YOUR_CURRENT_USER_NAME,   // optional
    email: YOUR_CURRENT_USER_EMAIL  // optional
  }
}
</script>

⚠️ IMPORTANT: Script Order Matters

The window.FrankoUser identity snippet must be executed before the main Franko embed script loads, otherwise user data will be missed.

Reliable Pattern: Place the identity information in the same script tag as your Franko loader to guarantee correct order:
<script>
(function() {
  // 1. Set user identity first
  window.FrankoUser = {
    user_id: "user-123",
    user_metadata: { name: "Ada Lovelace", email: "ada@example.com" }
  };

  // 2. Then load Franko embed script
  if (!window.FrankoModal) {
    window.FrankoModal = (...a) => { /* ...Franko loader code... */ };
    // ...rest of your Franko embed code...
  }
})();
</script>

That’s it! Franko will now associate feedback with this user.

What data is stored?

user_id - Your unique identifier for the user
user_metadata - Only name and email (both optional)

Common patterns

Pattern	Implementation
Show user info only when logged in	Wrap the snippet in your auth check
Different user data per page	Update `window.FrankoUser` dynamically

Compatible with embedding methods

This identity pattern works with both Chat Bubbles and Custom Triggers. Not compatible with Shareable Links, but you can configure to ask for name and email on the “Connect” tab.

What if the snippet is missing?

The User column shows “Anonymous” instead of the user details.

FAQ

Question	Answer
Is this required?	No – skip it if anonymous feedback is fine
Does it work with Direct Links?	No – direct links open in new tabs without access to your session
Can I update user data dynamically?	Yes – set `window.FrankoUser` before calling `FrankoModal.open()`
Is HTTPS required?	Yes – always use HTTPS for security

Need help? Email fletcher@franko.ai

​How it works

​What data is stored?

​Common patterns

​Compatible with embedding methods

​What if the snippet is missing?

​FAQ

How it works

What data is stored?

Common patterns

Compatible with embedding methods

What if the snippet is missing?

FAQ