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: "[e-mail]" }
  };

  // 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 [e-mail]