Meta Business Help Centre
Troubleshoot the event setup tool for web in Meta Events Manager
Learn about issues that you may encounter while trying to use the event setup tool on your website, and how to resolve the issues.
Troubleshoot error and warning messages
You see an error that says the event setup tool can't detect a Meta pixel on your website.
This may be because:
- Your pixel is in an inline frame (iframe), or the UI button that you're trying to set up is in an iframe. Instead of using the event setup tool, you can set up events manually using code. Learn how to set up a pixel on your website.
- You're using an IMG pixel. To resolve this issue, set up the pixel using javascript. Learn how to set up a pixel on your website.
- You entered the URL incorrectly. To resolve this issue, make sure that you typed the website URL correctly into the event setup tool.
- You don't have a pixel set up on your website. To resolve this issue, set up a pixel on your website. If you have already set up a pixel, use the test events tool to make sure that we're receiving events from your pixel.
- The code in your response header is blocking the event setup tool from detecting your pixel. Certain types of code in your website's response header may block the event setup tool from detecting your pixel. To resolve this issue, you may need help from a developer to remove this header from your website's code.
You see a warning that says we haven't recently received any events from your pixel.
To resolve this issue, install the pixel base code on your website and make sure that we've received at least one event from your pixel. To track a new URL, we need to receive the Page view event. To track a new button, we need to receive any event. Learn how to set up a pixel on your website.
You see a warning message that the standard event you're trying to set up is already set up in code.
If you have manually set up events using code in the past, you can use the event setup tool to set up different events. If you try to use the event setup tool to set up a standard event that has already been added using code, you'll receive a warning message so that you don't set it up twice.
Troubleshoot issues with opening the tool or clicking buttons in the tool
The event setup tool won't open on your web page.
This may be because your pixel is in an inline frame (iframe), or the UI button you're trying to set up is in an iframe. Instead of using the event setup tool, you can set up events manually using code. Learn how to set up a pixel on your website.
Buttons in the event setup tool are unresponsive.
This may be because the event setup tool is being intercepted by jQuery script. To resolve this issue, you may need help from a developer to modify the script so that button clicks are not intercepted, or remove the script from the page. If you're not able to modify or remove the script, you can manually set up events on a button click instead of using the event setup tool. Visit Meta for Developers to learn how to track clicks on buttons.
Buttons in the event setup tool are grey and you can't click on them.
This may be because:
- There are no buttons on the Page.
- There are buttons on the Page, but you've already added an event to all of them.
- There are buttons on the Page, but the event setup tool can't detect them because they're in an iframe. To resolve this issue, you can use a different setup method. To track a button, you can set up events manually using code, and to track a URL, you can set up a custom conversion.
The event setup tool opens on your website, but you can't set up events.
This may be because you don't have the right permissions. You must have admin access to the pixel to use the event setup tool. Learn how to add people to your pixel.
Troubleshoot issues with setting up events
The event that you want to set up doesn't appear in the suggestions.
If there are events you'd like to set up that haven't been suggested, you can navigate through your website and add events to buttons or to Page URLs.
You're unable to add an event to one of the buttons on your website.
Buttons are available to set up through the event setup tool if:
- They are an HTML button, an HTML link or an element that has a class or ID that matches button, btn or other variant spelling.
- Their height is no less than 10 pixels and no more than 600 pixels. Buttons that are too small or too large won't appear.
- They contain an image or text. Buttons won't appear if they only contain icons or numbers, such as search icons and phone numbers.
You're unable to set up an event on just one specific button on your website.
When you use the event setup tool to set up an event on a button, you select an event and a button that matches that event. This adds the event to the button you selected and to all buttons with the same or similar text on your website. For example, you want to set up an initiate checkout event on a Checkout button. You have several Checkout buttons on different pages of your website. When you set up the initiate checkout event using the event setup tool, the tool will add the event to each Checkout button.
You want to set up an event for a button that you have to hover over to see, such as a button that exists in a menu.
The event setup tool may not allow you to select this as a button. If that's the case, you can click Track URL and set up an event using the button's destination URL. For example, if a button takes people to the Men's Shoes page of your website, you can set up a URL rule using the Men's Shoes web page URL.
Troubleshoot issues with setting up parameters
You're unable to add parameters to your events.
At the moment, we only support value and currency parameters for standard events. We also support content ID and content type parameters for view content, add to cart, initiate checkout, purchase, search, add to wishlist and lead events. We don't currently support dynamic parameters.
You're unable to find the content ID using the event setup tool.
To set up content ID and content type parameters, a unique product identifier should be available either in your web page text or web page URL. For example, a product SKU or UPC.
Troubleshoot issues with reporting in Meta Events Manager
You use a partner integration or a redirect to a third-party website and see issues such as events being reported twice or not at all.
If you use a partner integration, you may see issues with the event setup tool such as events being reported twice. If you use a redirect to a third-party website that doesn't have your pixel code on it, the event setup tool won't work on the third-party website. To resolve these issues, you can add your pixel base code to the third-party website, or consider setting up the pixel base code on your website using code instead of a partner integration. Learn how to set up a pixel on your website.
You've set up events with parameters, but the parameters aren't showing up in Events Manager.
After you set up parameters, they can take 20 minutes to attach to events and start appearing in Events Manager. If we receive events from the pixel within that time frame, events won't show parameters.