Userflow.js installation check

One can preview content with the chrome extension, but to be able to publish content to your users you need to install Userflow.js.

If you believe you have already done this, but are in doubt of whether it is running correctly, then please run through this guide.

Check the User list

The quickest way to tell if user data is flowing from your app to Userflow is by going to the Users tab in the Userflow UI. If the user you’re signed in to your app with appears near the top of the list (sort by Last Seen descending), then Userflow.js is installed. Make sure you look at the right environment (switch in the top right corner).

Check the browser console and network tab

If the user is not showing up as recently seen in the User list, then please check the following:

  • Open a new fresh tab in Chrome.
  • Open Devtools (press F12 on your keyboard).
  • Switch to the Console tab.
  • Navigate to your app, where Userflow.js is supposed to be installed.
  • Check in the Console to see if there are any noticeable Userflow-related errors. If there are, try to resolve them or reach out to us for help.
  • Next, switch to the Network tab.
  • Filter by userflow.js and verify that is loaded: Network panel showing userflow.js
  • Finally, filter by and verify that a WebSocket connection is opened to wss:// Network panel showing Websocket

If userflow.js shows but the websocket connection doesn’t then userflow.js is installed, but it is potentially either not running identify() on all pages (required) or it is blocked by your network. In some cases e.g. a firewall or content security policy may block the connection.

Got questions? We're here for you!

The best way to get help is to
We usually reply within 5 minutes
You can also send an email to
We usually reply within a few hours