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

# Meta Pixel Integration

> Track form conversions and build retargeting audiences

![Meta](https://mintcdn.com/orbitai-d647f397/T1yKN7sdBmMTM8cv/_images/integrations/meta.svg?fit=max\&auto=format\&n=T1yKN7sdBmMTM8cv\&q=85\&s=4c751c699705b3ba6f401dc352aa79d8)

[Visit Meta Events Manager](https://business.facebook.com/events_manager)

## Overview

The Meta Pixel (formerly Facebook Pixel) tracks when visitors view and submit your forms. Use this data to measure ad effectiveness, optimize for conversions, and build custom audiences for retargeting.

> [card] Page View Tracking
>
> Track when visitors land on your form

> [card] Conversion Tracking
>
> Measure when forms are submitted

> [card] Custom Audiences
>
> Build audiences from form interactions

> [card] Ad Optimization
>
> Let Meta optimize for form completions

> [!NOTE]
>
> **Note:** This integration sends browser-side events only. For server-side tracking via Meta's Conversion API, see the [Cometly integration](https://docs.useorbitcrm.ai/integrations/cometly.md).

## Setup Guide

### Step 1: Get Your Pixel ID from Meta

**1. Open Meta Events Manager**

Go to Meta Events Manager in your browser.

[business.facebook.com/events\_manager](https://business.facebook.com/events_manager)

**2. Select your Pixel**

Click on "Data sources" in the left sidebar, then select your Meta Pixel from the list.

**3. Find your Pixel ID**

Your Pixel ID is displayed at the top of the page. It's a 15-16 digit number.

**4. Copy the ID**

Copy this number. You'll paste it into OrbitForms in the next step.

Example: `123456789012345`

> [!WARNING]
>
> **Don't have a Pixel yet?** You'll need to create one first in Meta Events Manager. Go to [Events Manager](https://business.facebook.com/events_manager) → Connect Data Sources → Web → Meta Pixel.

### Step 2: Connect the Pixel in OrbitForms

**1. Open your form in OrbitForms**

Go to your dashboard and click on the form you want to track.

**2. Click the 'Integrate' tab**

In the form editor, find and click the "Integrate" tab at the top.

**3. Find Meta Pixel**

Scroll down to find "Meta Pixel" under the Tracking & Analytics section.

**4. Click to configure**

Click on the Meta Pixel card to open the configuration modal.

**5. Enter your Pixel ID**

Paste the 15-16 digit Pixel ID you copied from Meta Events Manager.

**6. Choose your events**

Select which events to track (see event options below). We recommend the custom events for detailed tracking.

**7. Save your form**

Click "Save". The pixel will now fire whenever your form is viewed or submitted.

## Event Options

OrbitForms sends two types of events to your Meta Pixel. Choose the event type that best fits your tracking needs:

### Page View Event

Fires when a visitor loads your form. Choose one:

* **Custom: OrbitFormPageView** — **Recommended.** Includes form\_slug and form\_name for detailed tracking per form.
* **Standard: PageView** — Meta's standard page view event. Simpler but less form-specific.
* **Disabled** — Don't fire any page view event. Use this if you only want to track submissions.

### Form Submission Event

Fires when a visitor submits your form. Choose one:

* **Custom: OrbitFormSubmitted** — **Recommended** for detailed tracking. Includes form\_slug and form\_name.
* **Standard: Lead** — Best for lead generation forms. Helps Meta optimize ad delivery for lead conversions.
* **Standard: CompleteRegistration** — Best for signup and registration forms.
* **Disabled** — Don't fire any submission event. Use this if you only want to track page views.

## Step 3: Verify Your Pixel is Working

After connecting your pixel, verify that events are being received by Meta:

**1. Install Meta Pixel Helper (optional)**

The Meta Pixel Helper Chrome extension shows you in real-time what events are firing on a page.

[Install from Chrome Web Store](https://chrome.google.com/webstore/detail/meta-pixel-helper/fdgfkebogiimcoedlicjlajpkdmockpc)

**2. Visit your form**

Open your form in a new browser tab. If using the Pixel Helper, you should see the PageView event fire.

**3. Submit a test entry**

Fill out and submit your form with test data. This will trigger the submission event.

**4. Check Meta Events Manager**

Go to Events Manager and look at your Pixel's Overview or Test Events. You should see your events within a few minutes.

[Events Manager](https://business.facebook.com/events_manager)

> [!TIP]
>
> **Tip: Use Test Events** — In Events Manager, click "Test Events" to see events in real-time as they fire. This is faster than waiting for the main Overview to update.

## Advanced: Custom Events

> [!WARNING]
>
> **Important: Choose one method only.** Use the built-in Meta Pixel integration above (enter Pixel ID and select events) rather than adding your own pixel code elsewhere. Running both the built-in integration and a second copy of the pixel will cause duplicate events to fire.

Need more control? The event options above cover most use cases: the **Custom** events (`OrbitFormPageView` / `OrbitFormSubmitted`) include `form_slug` and `form_name`, and the **Standard** events (`PageView`, `Lead`, `CompleteRegistration`) map directly to Meta's optimization goals.

Note: the form's Custom JavaScript field runs in an isolated sandbox and cannot call `fbq`, so it can't be used to fire additional pixel events—configure your events with the built-in options instead.

## Server-Side Tracking

**Want Conversion API (Server Events)?**

The Meta Pixel integration uses browser-side tracking, which can be blocked by ad blockers. For server-side tracking with Meta's Conversion API, we recommend using [Cometly](https://docs.useorbitcrm.ai/integrations/cometly.md).

Cometly provides first-party attribution with server-side event tracking, bypassing browser limitations for more accurate conversion data.

## Troubleshooting

> [accordion] Events not showing in Events Manager?
>
> Events can take up to 20 minutes to appear in the Overview. Use the "Test Events" tab for real-time verification, or install the [Meta Pixel Helper](https://chrome.google.com/webstore/detail/meta-pixel-helper/fdgfkebogiimcoedlicjlajpkdmockpc) Chrome extension to verify events are firing correctly.

> [accordion] Numbers don't match form submissions?
>
> Browser tracking can be blocked by ad blockers, privacy extensions, or browser settings. For more accurate tracking, consider using [Cometly](https://docs.useorbitcrm.ai/integrations/cometly.md) for server-side events.

> [accordion] Invalid Pixel ID error?
>
> Pixel IDs are 15-16 digit numbers only. Make sure you're copying the correct ID from Events Manager (not the Pixel name), and that there are no extra spaces.

> [accordion] Duplicate events firing?
>
> Check that the pixel isn't also installed by another tag manager on the same page (e.g. via Google Tag Manager), or that your form isn't embedded on a page that already loads the same pixel. Choose one installation method to avoid duplicates.

> [accordion] Pixel Helper shows errors?
>
> Common issues include: Pixel ID mismatch (check the ID is correct), no events detected (the page may not have fully loaded), or "Pixel did not load" (check for browser extensions blocking scripts).

## Resources

> [card] [Meta Events Manager](https://business.facebook.com/events_manager)
>
> Manage your pixels and events

> [card] [Meta Pixel Documentation](https://www.facebook.com/business/help/952192354843755)
>
> Official Meta documentation

> [card] [Meta Pixel Helper](https://chrome.google.com/webstore/detail/meta-pixel-helper/fdgfkebogiimcoedlicjlajpkdmockpc)
>
> Chrome extension for debugging

> [card] [Meta Pixel Reference](https://developers.facebook.com/docs/meta-pixel/reference)
>
> Developer documentation

***

**Ready to Track Your Forms?** Set up Meta Pixel in minutes and start measuring your form conversions. [Get Started](https://app.useorbitcrm.ai/signin)


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