# X (Twitter) Pixel

> Adds the X (formerly Twitter) website tag to every public page for conversion tracking and audiences, with an option to wait for cookie consent.

- Type: PHP
- Runs: Frontend only
- Category: [Analytics & Tracking](https://wpide.com/library/category/analytics/)
- Tags: x, twitter, pixel, ads
- Author: WPIDE Team
- Installs: 0
- Updated: 2026-10-28
- Page: https://wpide.com/library/analytics-x-pixel/

## Code

```php
add_action( 'wp_head', function () {
    $pixel_id        = 'YOUR_PIXEL_ID'; // X pixel ID.
    $require_consent = false;           // true: wait for consent from the WPIDE cookie banner.

    if ( 'YOUR_PIXEL_ID' === $pixel_id || current_user_can( 'edit_posts' ) ) {
        return;
    }
    ?>
<script>
(function (run) {
    if (!<?php echo $require_consent ? 'true' : 'false'; ?> || /(?:^|; )wpide_consent=granted/.test(document.cookie)) { run(); return; }
    document.addEventListener('wpide:consent', function (e) { if (e.detail === 'granted') { run(); } });
})(function () {
    if (!window.twq) {
        var q = window.twq = function () { q.exe ? q.exe.apply(q, arguments) : q.queue.push(arguments); };
        q.version = '1.1';
        q.queue = [];
        var s = document.createElement('script');
        s.async = true;
        s.src = 'https://static.ads-twitter.com/uwt.js';
        document.head.appendChild(s);
    }
    twq('config', <?php echo wp_json_encode( $pixel_id ); ?>);
});
</script>
    <?php
} );
```

## Notes

Replace YOUR_PIXEL_ID with the pixel ID from X Ads > Tools > Events Manager. Nothing is output while the placeholder is in place.

## How to use it

Install the free WPIDE plugin (https://wordpress.org/plugins/wpide/), find "X (Twitter) Pixel" in its snippet library and add it in one click; or create a new PHP snippet in WPIDE (or any code snippets plugin) and paste the code above. More snippets: https://wpide.com/library/