# 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="/files/IObtloaRrSkqGg01tUtN" 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="/files/h3ceRp3zOS3T3uAnjq5Z" 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.powerfulform.com/app-integration/facebook-pixel-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
