---
title: "Installing the Userflow Chrome Extension"
slug: "userflow-chrome-extension"
tags: ["Userflow Extension", "Preview Flows", "Debugger Tool"]
updated: 2026-10-15T17:56:20Z
published: 2026-10-15T17:56:20Z
canonical: "help.userflow.com/userflow-chrome-extension"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.userflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Installing the Userflow Chrome Extension

The Userflow Chrome Extension is a browser add-on that allows you to preview Flows and other experiences you build in Userflow before they go live in your app and troubleshoot using our Debugger tool.

## How do I install the Userflow Chrome Extension?

1. Open the [Userflow extension in the Chrome Web Store](https://chromewebstore.google.com/detail/userflow/ojbompffhdcndgndakoghndckimkohca?hl=en-US).
2. Click **Add to Chrome**, then **Add extension** in the prompt.
3. Optional: click the puzzle-piece icon in the Chrome toolbar and pin Userflow so it's easy to find.
4. Give the extension access to your app. See What site access does the extension need?

## Preview flows before you publish

- You can preview Flows (e.g., product tours, modals, tooltips, etc.) directly in your app before installing the Userflow JavaScript snippet (Userflow.js) or publishing changes.
- Previewing lets you see how a flow will behave in context, helping catch UI or timing issues early.

## Debug and troubleshoot

- The extension includes the [Userflow Debugger](/docs/using-the-debugger-for-auto-start-conditions), a tool that shows why a particular Flow starts or doesn’t start.
- The Debugger is especially helpful for diagnosing targeting rules or trigger conditions that don’t behave as expected.

## What site access does the extension need?

To work correctly, the extension often needs your permission to read and modify site data on all sites you’re testing or on specific domains (such as your app). If it doesn’t have access, preview, and element selection can fail until you adjust these permissions.

To change it, click the puzzle-piece Extensions icon in the Chrome toolbar, click the three dots next to Userflow, and choose **This can read and change site data**. Select **On all sites**, or **On [your app's domain]** to limit it to your app.

If preview or element selection still doesn't work, see [Chrome Extension not working](/docs/chrome-extension-not-working).

## Related

- [Using the Debugger for auto-start conditions](/using-the-debugger-for-auto-start-conditions.md)
- [Flow builder basics](/flow-builder-basics.md)