1
Create a free Formbricks Cloud account
While you can self-host Formbricks, the quickest and easiest way to get started is with the free Cloud plan. Just sign up here and click through the onboarding.
2
Open Connect Your App
In your workspace, go to Settings and open Connect Your App under Workspace. This page holds the two values the SDK needs — your Workspace ID and your SDK Connection URL — and it tells you whether Formbricks has heard from your app yet.
3
Add the Formbricks SDK to your app
Copy the snippet under How to setup and paste it into the
<head> of every page of your website. It already carries your Workspace ID and SDK Connection URL, so there is nothing left to fill in.Running React, Next.js, Vue, React Native, Flutter, Swift or Kotlin instead? The framework guides wire up the same two values for each of them.4
Confirm the connection
Load the page you added the SDK to, then come back to Connect Your App. As soon as Formbricks receives the first data point, the App Connection card turns green:
Still grey? Hit Re-check — the page does not poll on its own. If it stays grey, turn on Debug Mode and read your browser console.
5
Create your first survey
Head back to Surveys, click New Survey and pick a template. Then open the Settings tab of the editor and set Survey Type to Website & App Survey — that is what makes the survey run inside your app instead of on a shareable link.
6
Create trigger to show survey
Still in the Settings tab, scroll to Survey Trigger and click Add action. On the Capture new action tab, name the action, choose Page View and click Create action. The survey now appears whenever the Formbricks widget detects a page load.
7
Set Recontact Options right
A common hiccup is users seeing one survey but it doesn’t appear again. This is due to the default settings we chose to avoid survey fatigue. While setting up, open Visibility & Recontact and choose Ignore Cooldown Period and Keep showing while conditions match:
Please change this setting after testing your survey to avoid user fatigue.
8
Publish the survey
Publish the survey to make it available for the SDK to pull into the website or app where you want to show
it.
9
Understand caching behavior
For better scalability, we cache the request the SDK makes to the server. This allows you to use Formbricks
on websites with millions of visitors without high hosting cost.For troubleshooting, you can enable Debug
Mode to see detailed logs
in your browser console.
Important: Any changes to surveys, action classes, or Workspace settings will
take up to 1 minute to reflect in your app/website due to server-side caching. This includes survey
modifications, new triggers, styling changes, and other updates.
10
Check browser compatibility
Formbricks is designed to work with all modern browsers. Please ensure your users are using a supported version:
Internet Explorer is not supported.