How-To/Instructional

Ezoic WordPress Plugin JavaScript Integration Guide

Last Updated a few days ago

Introduction

If you are an existing publisher who has been live with Ezoic for 30+ days, you can quickly set up your site using the default best practices by simply enabling JavaScript integration through the WordPress plugin. This will automatically insert Ezoic placeholders across your site based on proven default configurations. The system will relearn and optimize within 2–3 weeks, potentially delivering even better results. So if you'd prefer not to manually match placeholder IDs, please skip step 5 and 6 below.

This guide otherwise helps existing Ezoic publishers migrate to the updated WordPress plugin with JavaScript integration while also retaining top-performing placeholders and avoiding revenue disruption.

Instructions

Step 1: Install or Update the Ezoic Plugin

In your WordPress dashboard, go to Plugins > Add New
Search for "Ezoic"
Click Install and then Activate
If you already have the plugin installed, ensure it is updated to the latest version
Turn on Auto-Update for the Ezoic plugin in WordPress so you always have the latest features

Step 2: Configure ads.txt file

In WordPress, go to Settings > Ezoic > Ads.txt Setup tab
Select the Automatic Ads.txt Management (Auto-Redirect) option
This ensures your ads.txt file is always compliant and up to date
If needed, reference this guide: How to Setup Your Ads.txt File

Step 3: Remove Existing Ads

Before moving to JavaScript integration, ensure that any third-party ads (such as AdSense) are removed from your site. Having these run alongside Ezoic ads can negatively impact site performance and revenue optimization.

Disable any AdSense Auto Ads in your AdSense account.
Remove any hard-coded ad scripts from your site’s theme files, widgets, or header/footer areas.
Check for any third-party ad plugins and deactivate or remove them.

Important: Only Ezoic ads should be running once you complete this migration to ensure full optimization.

Step 4: Remove Cloud Integration

Before finalizing plugin integration, you’ll need to remove your legacy Cloud integration.

If your SSL is managed through Ezoic:

First, install a valid SSL certificate through your origin host or CDN (e.g., Let’s Encrypt, Cloudflare, or your web host)
Ensure HTTPS continues to function properly before deactivating Ezoic’s SSL or switching DNS
Failing to set up an SSL certificate outside of Ezoic may cause your site to go offline or display security warnings

If you used Cloudflare through Ezoic:

Go to Ezoic Dashboard > Settings > Site Integration
Click “Remove Cloudflare”

If you used name server integration:

Log into your domain registrar
Repoint the name servers back to your host (or original DNS provider). Note that this change can take up to 24 hours to propagate globally,

Step 5: Enable JavaScript Integration

Navigate to Settings > Ezoic > Dashboard
Click “Enable JavaScript Integration” or “Turn On JavaScript Integration”
Check each of the three boxes under the "Integration" tab and hit "Save Settings":
This will inject Ezoic’s JavaScript into your site header. No manual code or DNS changes are needed. Note that if you are using WP Rocket or any performance plugin that defers or delays scripts, you'll need to exclude Ezoic's scripts from this - see WP Rocket & Ezoic's JavaScript Integration - Best Practice Guide.

Step 6: Enable Advanced Placement Control

Before you can select or change placeholder IDs in the Ad Placements tab, you must enable Advanced Placement Control in the plugin:

Go to Settings > Ezoic > Ad Placements tab (you may need to click 'Let's Go!' under the Ad Placements tab before you see these options)
Navigate to Settings > Advanced
Under Advanced Placement Control, toggle “Enable Placement ID Selection” to the ON position
Once enabled, you will have access to manage placeholder IDs within the Ad Placements tab.

Note: This step is required to see and adjust placeholder IDs for optimizing revenue.

Step 7: Migrate Placeholder IDs

The plugin creates default WordPress-generated placeholders, but these may not match your top-performing units. Ezoic’s AI uses historical data to set dynamic bid floors, so retaining the original placeholder IDs is critical to maintaining revenue.Now, instead of using a worksheet, you can manage this process entirely within the plugin:

Go to Settings > Ezoic > Ad Placements in WordPress
In the Ad Placements tab, locate the dropdown menu for each ad location type (e.g., “Under Page Title”)
Next to each placeholder ID, you’ll see the revenue percentage generated by that placeholder type
Select the top-performing placeholder for each location type based on revenue percentage

Tip: If no data exists for a particular location type on your site, retain the default placeholder ID provided by the plugin. We highly recommend only updating the insertion point for custom or unique sites (e.g., single page tool sites).

Step 8: Update your Privacy Policy

To comply with ad partner requirements and maintain transparency with visitors, you must update your site’s privacy policy to reflect your relationship with Ezoic.

Go to the Privacy section of your Ezoic Dashboard
Ensure your Privacy Policy is up to date and compliant.

This completes your transition to plugin integration.

Contact Information for Further Assistance

If you need further assistance with JS integration through the WordPress plugin, please log in via https://support.ezoic.com/ to make use of our dedicated resources for support. We're here to help!

Was this article helpful?