# Facebook Pixel integration

#### ✅  Before You Start

Before enabling this integration, make sure:

* A **Meta (Facebook) Pixel** is already installed on your Shopify store
* The pixel is working correctly (fbq function is available on your storefront)

### 🛠️ Steps to enable the integration

1. Open the app > click **Forms** > open a form
2. Click **Integration** on the left side of the form > find **Facebook Pixel** in the list and toggle it on
3. Click on **Facebook Pixel** to see the setting detail

<figure><img src="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FW9hXxEoh9QSiKgBFkamg%2F2026-01-30_17-01-17.png?alt=media&#x26;token=7addabaf-81e0-4bdb-93e4-c1920b98853a" alt=""><figcaption></figcaption></figure>

4. Enter the name of the event you want to send to Facebook Pixel (e.g., `FormSubmission`, `Lead`, `ContactForm`)

<figure><img src="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FDbjcevsVX6I1bEFYfeCt%2F2025-09-30_15-04-28.png?alt=media&#x26;token=c46fe95d-76cf-470d-b821-a310f6af00a0" alt=""><figcaption></figcaption></figure>

> If you enter `ContactForm`, then whenever someone submits your form, Facebook Pixel will record this event with that name.

5. Save the form

Submit your form on the storefront to test the result.&#x20;

***

### ✅ How it works

When a customer submits a form on your storefront, the app processes the event in the following steps:

#### 1️⃣ Check if the integration is enabled

The app first checks whether the **Facebook Pixel integration** is enabled for the form.

#### 2️⃣ Detect the Meta Pixel on the page

Next, the app checks if the Meta Pixel is properly loaded on the page by detecting the `fbq` function.

> The `fbq` function is provided by Meta Pixel and is required to track events on your store.

If the Meta Pixel is not detected, the event will not be sent.

#### 3️⃣ Send the custom event to Meta Pixel

If both conditions are met:

* The integration is enabled
* The Meta Pixel (`fbq`) function is available

The app sends a **custom event** to Meta Pixel using the event name you configured in the app.

#### 4️⃣ Data included with the event

Along with the event name, the following data is sent to Meta Pixel:

* **Page title** – the title of the page where the form was submitted
* **Page URL** – the URL of the page where the submission occurred
* **Form title** – the name of the submitted form

#### 5️⃣ View the event in Meta Events Manager

After the event is sent:

* It will appear in **Meta Events Manager** as a **custom event**
* Processing may take 15–30 minutes
* You can view event activity, match quality, and integration source

***

#### **Need More Help?**

If you still need assistance, please contact us at [**support@powerfulform.com**](mailto:support@powerfulform.com)

Our team will be happy to help you resolve any issues or guide you further.