---
description: Capacitor plugin to integrate Formbricks on Android, iOS, and Web. Supports form submissions, analytics, and user feedback.
title: Capacitor Formbricks Plugin for Android, iOS & Web - Capawesome
image: https://capawesome.io/docs/assets/images/social/plugins/formbricks.png
---

[ Skip to content](#capawesomecapacitor-formbricks) 

[ 🎉 Introducing **Capawesome Platform** — one platform for Live Updates, Native Builds, App Store Publishing, and Insider SDKs.](https://capawesome.io) 

* Formbricks [  Formbricks ](/docs/plugins/formbricks/)
* [  iOS ](#ios)
* [  Configuration ](#configuration)
* [  Usage ](#usage)
* [  API ](#api)
* [  Changelog ](#changelog)
* [  License ](#license)
* [  Geocoder ](/docs/plugins/geocoder/)
* [  Google Sign-In ](/docs/plugins/google-sign-in/)
* [  libSQL ](/docs/plugins/libsql/)
* [  Live Update ](/docs/plugins/live-update/)
* [  Managed Configurations ](/docs/plugins/managed-configurations/)
* [  Media Session ](/docs/plugins/media-session/)
* [  ML Kit ](/docs/plugins/mlkit/)
* [  NFC ](/docs/plugins/nfc/)
* [  OAuth ](/docs/plugins/oauth/)
* [  Pedometer ](/docs/plugins/pedometer/)
* [  Photo Editor ](/docs/plugins/photo-editor/)
* [  PostHog ](/docs/plugins/posthog/)
* [  Printer ](/docs/plugins/printer/)
* [  Purchases ](/docs/plugins/purchases/)
* [  RealtimeKit ](/docs/plugins/realtimekit/)
* [  Screen Orientation ](/docs/plugins/screen-orientation/)
* [  Screenshot ](/docs/plugins/screenshot/)
* [  Secure Preferences ](/docs/plugins/secure-preferences/)
* [  Speech Recognition ](/docs/plugins/speech-recognition/)
* [  Speech Synthesis ](/docs/plugins/speech-synthesis/)
* [  Share Target ](/docs/plugins/share-target/)
* [  Square Mobile Payments ](/docs/plugins/square-mobile-payments/)
* [  SQLite ](/docs/plugins/sqlite/)
* [  Superwall ](/docs/plugins/superwall/)
* [  Torch ](/docs/plugins/torch/)
* [  Wifi ](/docs/plugins/wifi/)
* [  Zip ](/docs/plugins/zip/)
* [  Cloud ](/docs/cloud/)
* [  Live Updates ](/docs/cloud/live-updates/)
* Advanced
* Integrations
* [  Native Builds ](/docs/cloud/native-builds/)
* [  Configuration ](/docs/cloud/native-builds/configuration/)
* [  Environments ](/docs/cloud/native-builds/environments/)
* Guides
* [  Sample Projects ](/docs/cloud/native-builds/sample-projects/)
* [  Troubleshooting ](/docs/cloud/native-builds/troubleshooting/)
* [  Automations ](/docs/cloud/automations/)
* [  Assist ](/docs/cloud/assist/)
* Account
* Organizations
* [  Organization and User Management ](/docs/cloud/organizations/memberships/)
* [  Single Sign-On (SSO) ](/docs/cloud/organizations/sso/)
* [  Teams ](/docs/cloud/organizations/teams/)
* [  Two-Factor Authentication ](/docs/cloud/organizations/two-factor-authentication/)
* [  Integrations ](/docs/cloud/integrations/)
* [  License Keys ](/docs/cloud/license-keys/)
* [  Webhooks ](/docs/cloud/webhooks/)
* [  Pricing ](https://capawesome.io/pricing/)
* [  FAQ ](/docs/cloud/faq/)
* [  Support ](/docs/cloud/support/)
* [  Contributing ](/docs/contributing/)
* [  LLMs ](/docs/llms/)
* [  Insiders ](/docs/insiders/)
* [  License ](https://capawesome.io/legal/eula/)
* [  Support ](/docs/insiders/support/)
* [  FAQ ](/docs/insiders/faq/)
* [  Blog ](/blog/)
* Categories

* [  iOS ](#ios)
* [  Configuration ](#configuration)
* [  Usage ](#usage)
* [  API ](#api)
* [  Changelog ](#changelog)
* [  License ](#license)

# @capawesome/capacitor-formbricks[¶](#capawesomecapacitor-formbricks "Permanent link")

Unofficial Capacitor plugin for [Formbricks](https://formbricks.com/).[1](#fn:1)

[ ![Deliver Live Updates to your Capacitor app with Capawesome Cloud](../../assets/external/cloud.capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.69628c3f.png) ](https://cloud.capawesome.io/) 

## Newsletter[¶](#newsletter "Permanent link")

Stay up to date with the latest news and updates about the Capawesome, Capacitor, and Ionic ecosystem by subscribing to our [Capawesome Newsletter](https://cloud.capawesome.io/newsletter/).

## Compatibility[¶](#compatibility "Permanent link")

| Plugin Version | Capacitor Version | Status         |
| -------------- | ----------------- | -------------- |
| 0.1.x          | \>=8.x.x          | Active support |

## Installation[¶](#installation "Permanent link")

You can use our **AI-Assisted Setup** to install the plugin. Add the [Capawesome Skills](https://github.com/capawesome-team/skills) to your AI tool using the following command:

`[](#%5F%5Fcodelineno-0-1)npx skills add capawesome-team/skills --skill capacitor-plugins
`

Then use the following prompt:

`` [](#%5F%5Fcodelineno-1-1) Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome/capacitor-formbricks` plugin in my project.
 ``

If you prefer **Manual Setup**, install the plugin by running the following commands and follow the platform-specific instructions below:

`[](#%5F%5Fcodelineno-2-1)npm install @capawesome/capacitor-formbricks @formbricks/js
[](#%5F%5Fcodelineno-2-2)npx cap sync
`

### Android[¶](#android "Permanent link")

#### Variables[¶](#variables "Permanent link")

If needed, you can define the following project variable in your app's `variables.gradle` file to change the default version of the dependency:

* `$formbricksAndroidVersion` version of `com.formbricks:android` (default: `1.2.0`)

This can be useful if you encounter dependency conflicts with other plugins in your project.

#### Data Binding[¶](#data-binding "Permanent link")

The Formbricks Android SDK requires Data Binding to be enabled in your app's `build.gradle` file:

`[](#%5F%5Fcodelineno-3-1)android {
[](#%5F%5Fcodelineno-3-2)    buildFeatures {
[](#%5F%5Fcodelineno-3-3)        dataBinding true
[](#%5F%5Fcodelineno-3-4)    }
[](#%5F%5Fcodelineno-3-5)}
`

### iOS[¶](#ios "Permanent link")

#### Minimum Deployment Target[¶](#minimum-deployment-target "Permanent link")

If you are using **Swift Package Manager**, make sure that your iOS deployment target is set to at least `16.6` in your Xcode project settings (usually in `ios/App/App.xcodeproj`):

`[](#%5F%5Fcodelineno-4-1)-IPHONEOS_DEPLOYMENT_TARGET = 15.0
[](#%5F%5Fcodelineno-4-2)+IPHONEOS_DEPLOYMENT_TARGET = 16.6
`

If you are using **CocoaPods**, make sure that your iOS deployment target is set to at least `16.6` in your `Podfile`:

`[](#%5F%5Fcodelineno-5-1)platform :ios, '16.6'
`

## Configuration[¶](#configuration "Permanent link")

No configuration required for this plugin.

## Usage[¶](#usage "Permanent link")

`[](#%5F%5Fcodelineno-6-1)import { Formbricks } from '@capawesome/capacitor-formbricks';
[](#%5F%5Fcodelineno-6-2)
[](#%5F%5Fcodelineno-6-3)const setup = async () => {
[](#%5F%5Fcodelineno-6-4)  await Formbricks.setup({
[](#%5F%5Fcodelineno-6-5)    appUrl: 'https://app.formbricks.com',
[](#%5F%5Fcodelineno-6-6)    environmentId: 'YOUR_ENVIRONMENT_ID',
[](#%5F%5Fcodelineno-6-7)  });
[](#%5F%5Fcodelineno-6-8)};
[](#%5F%5Fcodelineno-6-9)
[](#%5F%5Fcodelineno-6-10)const setUserId = async () => {
[](#%5F%5Fcodelineno-6-11)  await Formbricks.setUserId({
[](#%5F%5Fcodelineno-6-12)    userId: 'user-123',
[](#%5F%5Fcodelineno-6-13)  });
[](#%5F%5Fcodelineno-6-14)};
[](#%5F%5Fcodelineno-6-15)
[](#%5F%5Fcodelineno-6-16)const setAttribute = async () => {
[](#%5F%5Fcodelineno-6-17)  await Formbricks.setAttribute({
[](#%5F%5Fcodelineno-6-18)    key: 'plan',
[](#%5F%5Fcodelineno-6-19)    value: 'pro',
[](#%5F%5Fcodelineno-6-20)  });
[](#%5F%5Fcodelineno-6-21)};
[](#%5F%5Fcodelineno-6-22)
[](#%5F%5Fcodelineno-6-23)const setAttributes = async () => {
[](#%5F%5Fcodelineno-6-24)  await Formbricks.setAttributes({
[](#%5F%5Fcodelineno-6-25)    attributes: {
[](#%5F%5Fcodelineno-6-26)      plan: 'pro',
[](#%5F%5Fcodelineno-6-27)      tier: 'gold',
[](#%5F%5Fcodelineno-6-28)    },
[](#%5F%5Fcodelineno-6-29)  });
[](#%5F%5Fcodelineno-6-30)};
[](#%5F%5Fcodelineno-6-31)
[](#%5F%5Fcodelineno-6-32)const setLanguage = async () => {
[](#%5F%5Fcodelineno-6-33)  await Formbricks.setLanguage({
[](#%5F%5Fcodelineno-6-34)    language: 'de',
[](#%5F%5Fcodelineno-6-35)  });
[](#%5F%5Fcodelineno-6-36)};
[](#%5F%5Fcodelineno-6-37)
[](#%5F%5Fcodelineno-6-38)const track = async () => {
[](#%5F%5Fcodelineno-6-39)  await Formbricks.track({
[](#%5F%5Fcodelineno-6-40)    action: 'button_pressed',
[](#%5F%5Fcodelineno-6-41)  });
[](#%5F%5Fcodelineno-6-42)};
[](#%5F%5Fcodelineno-6-43)
[](#%5F%5Fcodelineno-6-44)const logout = async () => {
[](#%5F%5Fcodelineno-6-45)  await Formbricks.logout();
[](#%5F%5Fcodelineno-6-46)};
`

## API[¶](#api "Permanent link")

* [logout()](#logout)
* [setAttribute(...)](#setattribute)
* [setAttributes(...)](#setattributes)
* [setLanguage(...)](#setlanguage)
* [setUserId(...)](#setuserid)
* [setup(...)](#setup)
* [track(...)](#track)
* [Interfaces](#interfaces)

### logout()[¶](#logout "Permanent link")

`[](#%5F%5Fcodelineno-7-1)logout() => Promise<void>
`

Log out the current user and clear all attributes.

**Since:** 0.1.0

---

### setAttribute(...)[¶](#setattribute "Permanent link")

`[](#%5F%5Fcodelineno-8-1)setAttribute(options: SetAttributeOptions) => Promise<void>
`

Set a single user attribute.

| Param       | Type                                        |
| ----------- | ------------------------------------------- |
| **options** | [SetAttributeOptions](#setattributeoptions) |

**Since:** 0.1.0

---

### setAttributes(...)[¶](#setattributes "Permanent link")

`[](#%5F%5Fcodelineno-9-1)setAttributes(options: SetAttributesOptions) => Promise<void>
`

Set multiple user attributes at once.

| Param       | Type                                          |
| ----------- | --------------------------------------------- |
| **options** | [SetAttributesOptions](#setattributesoptions) |

**Since:** 0.1.0

---

### setLanguage(...)[¶](#setlanguage "Permanent link")

`[](#%5F%5Fcodelineno-10-1)setLanguage(options: SetLanguageOptions) => Promise<void>
`

Set the survey language.

| Param       | Type                                      |
| ----------- | ----------------------------------------- |
| **options** | [SetLanguageOptions](#setlanguageoptions) |

**Since:** 0.1.0

---

### setUserId(...)[¶](#setuserid "Permanent link")

`[](#%5F%5Fcodelineno-11-1)setUserId(options: SetUserIdOptions) => Promise<void>
`

Set the user ID of the current user.

| Param       | Type                                  |
| ----------- | ------------------------------------- |
| **options** | [SetUserIdOptions](#setuseridoptions) |

**Since:** 0.1.0

---

### setup(...)[¶](#setup "Permanent link")

`[](#%5F%5Fcodelineno-12-1)setup(options: SetupOptions) => Promise<void>
`

Setup the Formbricks SDK with the provided options.

**Attention**: This method must be called before any other method.

| Param       | Type                          |
| ----------- | ----------------------------- |
| **options** | [SetupOptions](#setupoptions) |

**Since:** 0.1.0

---

### track(...)[¶](#track "Permanent link")

`[](#%5F%5Fcodelineno-13-1)track(options: TrackOptions) => Promise<void>
`

Track an action that may trigger a survey.

| Param       | Type                          |
| ----------- | ----------------------------- |
| **options** | [TrackOptions](#trackoptions) |

**Since:** 0.1.0

---

### Interfaces[¶](#interfaces "Permanent link")

#### SetAttributeOptions[¶](#setattributeoptions "Permanent link")

| Prop      | Type   | Description                 | Since |
| --------- | ------ | --------------------------- | ----- |
| **key**   | string | The name of the attribute.  | 0.1.0 |
| **value** | string | The value of the attribute. | 0.1.0 |

#### SetAttributesOptions[¶](#setattributesoptions "Permanent link")

| Prop           | Type                         | Description            | Since |
| -------------- | ---------------------------- | ---------------------- | ----- |
| **attributes** | { \[key: string\]: string; } | The attributes to set. | 0.1.0 |

#### SetLanguageOptions[¶](#setlanguageoptions "Permanent link")

| Prop         | Type   | Description                                         | Since |
| ------------ | ------ | --------------------------------------------------- | ----- |
| **language** | string | The language code of the survey language (e.g. de). | 0.1.0 |

#### SetUserIdOptions[¶](#setuseridoptions "Permanent link")

| Prop       | Type   | Description                      | Since |
| ---------- | ------ | -------------------------------- | ----- |
| **userId** | string | The user ID of the current user. | 0.1.0 |

#### SetupOptions[¶](#setupoptions "Permanent link")

| Prop              | Type   | Description                                    | Since |
| ----------------- | ------ | ---------------------------------------------- | ----- |
| **appUrl**        | string | The URL of your Formbricks instance.           | 0.1.0 |
| **environmentId** | string | The environment ID of your Formbricks project. | 0.1.0 |

#### TrackOptions[¶](#trackoptions "Permanent link")

| Prop       | Type   | Description                      | Since |
| ---------- | ------ | -------------------------------- | ----- |
| **action** | string | The name of the action to track. | 0.1.0 |

## Changelog[¶](#changelog "Permanent link")

See [CHANGELOG.md](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/formbricks/CHANGELOG.md).

## License[¶](#license "Permanent link")

See [LICENSE](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/formbricks/LICENSE).

---

1. This project is not affiliated with, endorsed by, sponsored by, or approved by Formbricks GmbH or any of their affiliates or subsidiaries. [↩](#fnref:1 "Jump back to footnote 1 in the text")

May 17, 2026 

 Back to top