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

# Setup Web & Mobile SDK connection

> App surveys deliver 6–10x higher conversion rates compared to email surveys. If you are new to Formbricks, follow the steps in this guide to launch a survey in your web or mobile app (React Native) within 10–15 minutes.

**1. Create a free Formbricks Cloud account**

While you can [self-host](https://formbricks.com/docs/self-hosting/overview.md) Formbricks, the quickest and easiest way to get started is with the free Cloud plan. Just [sign up here](https://app.formbricks.com/auth/signup) and click through the onboarding.

**2. Open Web & Mobile SDK**

In your workspace, go to **Settings** and open **Web & Mobile SDK** under **Workspace**. **Workspace details** holds the two values the SDK needs — your **Workspace ID** and your **SDK Connection URL** — and the **Connection status** card tells you whether Formbricks has heard from your app yet.

![The Web & Mobile SDK settings page with a grey Connection status card reading "Formbricks SDK is not yet connected", the Workspace details card and the How to install card](https://mintcdn.com/formbricks/NDmI58oj428gm6rb/images/surveys/website-app-surveys/quickstart/web-and-mobile-sdk.webp?fit=max\&auto=format\&n=NDmI58oj428gm6rb\&q=85\&s=6bc98ff89a0080fd5a7dab86f7b1ddc2)

> [!NOTE]
>
> Not the person who will add the SDK? The banner at the top of the page invites a technical team member into the organization so they can do this step for you.

**3. Add the Formbricks SDK to your app**

Under **How to install**, expand the method that matches your stack:

| Method | Covers |
| :- | :- |
| **Website** | HTML, React.js, Next.js, Vue.js |
| **Mobile** | React Native, Swift, Android, Flutter |
| **Google Tag Manager** | Any website, without touching its code |
| **WordPress** | WordPress sites, via the official plugin |

Each method gives you a handful of numbered steps and a snippet that already carries your Workspace ID and SDK Connection URL, so there is nothing left to fill in. For plain HTML, paste the snippet into the `<head>` of every page of your website.

![The How to install card with the Website method expanded, showing the HTML, React.js, Next.js and Vue.js tabs and the pre-filled HTML snippet](https://mintcdn.com/formbricks/NDmI58oj428gm6rb/images/surveys/website-app-surveys/quickstart/how-to-install.webp?fit=max\&auto=format\&n=NDmI58oj428gm6rb\&q=85\&s=3e2cef6c1134c09131c804a5d1c6a33a)

Each method also links out to its full guide: the [framework guides](https://formbricks.com/docs/surveys/website-app-surveys/framework-guides.md) for code, [Google Tag Manager](https://formbricks.com/docs/surveys/website-app-surveys/google-tag-manager.md) and [WordPress](https://formbricks.com/docs/platform/features/integrations/wordpress.md) for the no-code routes.

**4. Confirm the connection**

Open the website or launch the app you added the SDK to, then come back to **Web & Mobile SDK** and hit **Re-check**. Once Formbricks has the first data point, the **Connection status** card turns green:

![The Connection status card, green, reading "Receiving data" and "Formbricks SDK is connected"](https://mintcdn.com/formbricks/NDmI58oj428gm6rb/images/surveys/website-app-surveys/quickstart/connection-status.webp?fit=max\&auto=format\&n=NDmI58oj428gm6rb\&q=85\&s=22204246ca6877d3ba211703c24e64a1)

> [!NOTE]
>
> Still grey? The card only re-reads the status on **Re-check** or a page reload, so give the SDK a moment and check again. If it stays grey on the web, turn on [Debug Mode](https://formbricks.com/docs/surveys/website-app-surveys/framework-guides.md#activate-debug-mode) and read your browser console. On mobile, check your platform's log output instead — the Xcode console, Logcat, or your Metro or Flutter 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.

![The Survey Type section of the survey settings, with Website & App Survey selected](https://mintcdn.com/formbricks/5_352Ti9xBgcosL6/images/surveys/website-app-surveys/quickstart/survey-type.webp?fit=max\&auto=format\&n=5_352Ti9xBgcosL6\&q=85\&s=b00b29089c4bbe63176c6f7a3eeedf27)

**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.

![The Add action dialog on the Capture new action tab, with the No code action type and Page View selected](https://mintcdn.com/formbricks/5_352Ti9xBgcosL6/images/surveys/website-app-surveys/quickstart/page-view-action.webp?fit=max\&auto=format\&n=5_352Ti9xBgcosL6\&q=85\&s=8057c152e1cd557b6e135e4b7f2a3728)

**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 **Display & Recontact** and choose **Ignore Cooldown Period** and **Keep showing while conditions match**:

![The Display & Recontact section with Ignore Cooldown Period and Keep showing while conditions match selected](https://mintcdn.com/formbricks/5_352Ti9xBgcosL6/images/surveys/website-app-surveys/quickstart/recontact-options.webp?fit=max\&auto=format\&n=5_352Ti9xBgcosL6\&q=85\&s=55699078ec737e6b432877cb4cf3b498)

> [!NOTE]
>
> Please change this setting after testing your survey to avoid user fatigue.

**8. Activate the survey**

Activate 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.

> [!NOTE]
>
> **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.

For troubleshooting, you can enable [Debug
Mode](https://formbricks.com/docs/surveys/website-app-surveys/framework-guides.md#activate-debug-mode) to see detailed logs
in your browser console.

**10. Check browser compatibility**

Formbricks is designed to work with all modern browsers. Please ensure your users are using a supported version:

| Browser | Minimum Version | Release Date |
| :- | :- | :- |
| **Chrome** | 111+ | March 2023 |
| **Edge** | 111+ | March 2023 |
| **Firefox** | 128+ | July 2024 |
| **Safari** | 16.4+ | March 2023 |

*Internet Explorer is not supported.*

Need help? Join us in [**GitHub Discussions**](https://github.com/formbricks/formbricks/discussions), and we'll be happy to assist!


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.