Ad Inserter – Ad Manager & AdSense Ads


Ad management plugin with many advanced advertising features to insert ad codes at optimal positions.

Supports all kinds of ads including Google AdSense, Google Ad Manager (DFP – DoubleClick for publishers), contextual Amazon Native Shopping Ads, and rotating banners.

This plugin is more than AdSense plugin or plugin for ads. It provides many advanced options to insert opt-in forms, header scripts, Javascript, CSS, HTML, PHP, analytics, tracking or advert code anywhere on the page.

Insert ads where other plugins fail.
It’s all about the settings.

Plugin reviews:

I’ve been using another ad placement manager for a couple years and just recently started using Ad Inserter.

I’m blown AWAY with the power and flexibility of it.

I can HIGHLY recommend this plugin to anyone looking for an easy way to manage ads within WordPress.

Difficult to choose, but certainly top 3 plugins I’ve ever used in WordPress, ever.

Features – check documentation for the complete list

  • AdSense integration
  • Support for Google Ad Manager (DoubleClick for publishers)
  • Syntax highlighting editor
  • Code preview with visual CSS editor
  • Automatically inserts ads on posts and pages
  • Insert before or after post
  • Insert before or after content
  • Insert before or after paragraph
  • Insert before or after random paragraph
  • Insert before or after multiple paragraphs
  • Insert before or after image
  • Insert before or after comments
  • Insert before or after excerpt
  • Insert near any element on the page (using CSS selectors)
  • Insert above the header (after <body> tag)
  • Insert in the footer (before </body> tag)
  • Insert at relative positions in posts
  • Insert between posts on blog pages (in-feed AdSense)
  • Insert between excerpts on blog pages
  • Insert between comments
  • Insert at custom hook positions (do_action () WP function)
  • Insert before or after any HTML element using CSS selectors
  • Visual HTML element selector (DOM explorer)
  • Avoid inserting ads near images or headers (AdSense TOS)
  • Disable ads on individual posts or pages
  • Insert header (<head> section) and footer code
  • Insert raw HTTP response header lines
  • Insert Google Analytics, Matomo (Piwik) or any other tracking code
  • Insert images, HTML, CSS, Javascript or PHP code
  • Code generator for banners and placeholders
  • AdSense code generator
  • Visual advert editor – create adverts from scratch
  • Manual insertion: widgets, shortcodes, PHP function call
  • Sticky (fixed) widgets (sticky sidebar – the sidebar does not move when the page is scrolled)
  • Custom alignments and styles
  • Insert different ad codes on AMP pages
  • Custom CSS class name for wrapping divs to avoid ad blockers
  • Use shortcodes from other plugins
  • Use custom fields as defined in posts
  • Use post title, tags or category names to create contextual adverts
  • PHP code processing
  • Ad labels – show customized label above adverts
  • ads.txt editor
  • Support for GDPR consent checks
  • Support for IAB TCF 2.0 GDPR consent API (used by Quantcast Choice)
  • Ad rotation (server-side and client-side – works with caching)
  • Timed ad rotation – define times to rotate adverts in a single ad block
  • Create rich media ads with standard WordPress TinyMCE editor
  • Ad blocking detection – popup message, page redirection
  • Desktop/mobile device detection (server-side and client-side – works with caching)
  • Blacklist/Whitelist categories, tags, taxonomies, post IDs, urls, url query parameters, cookies, referrers, browsers, operating systems
  • Easy copying and pasting ads or settings using internal clipboard
  • Can wait for jQuery when it is deferred
  • Use it with Google Site Kit or replace it to have more control over ad placement
  • Simple troubleshooting with many debugging functions
  • Function to visualize inserted blocks
  • Function to visualize AdSense ads with ad names and IDs
  • Function to visualize available insertion positions
  • Function to visualize HTML tags
  • You name it 🙂

Review on WP Mayor

The Best WordPress Ad Management Plugin?

Review on ShoutMeLoud

Both Google and Amazon recommend this plugin for inserting ads, which is a testament to its quality

Endorsed by GoogleHow to insert ad code in your WordPress site

If you’re new to AdSense, one of your first tasks is to connect your site to AdSense. This requires you to copy the code on your AdSense homepage and paste it into the HTML of your page, between the <head> and </head> tags.

Endorsed by AmazonWordPress Integration Guide for Native Shopping Ads.

Native Shopping Ads provide highly relevant and dynamic product recommendations in a stylishly designed and responsive ad unit that can be placed at the end or within your content to create a more compelling visitor experience and shopping opportunity.

Pro version supports additional advanced features:

  • Geolocation using Webnet77 or MaxMind databases (works also with caching)
  • Country, state, region and city level geotargeting
  • Blacklist/Whitelist IP addresses or countries/cities (works also with caching)
  • Ad impression and click statistics (works also with <iframe> Javascript ads like Google AdSense)
  • Statistics reports for clients in PDF format or public web pages
  • External tracking via Google Analytics or Matomo (Piwik)
  • A/B testing – discover adverts and settings that perform best
  • Frequency capping – limit impressions or clicks
  • Click fraud protection
  • Lazy loading
  • Sticky ads with optional close button
  • Sticky sidebar ads (stick to the screen or to the content)
  • Floating slide-in banner adverts
  • Sticky (floating) ads with animations (fade, slide, turn, flip, zoom)
  • Animation trigger for sticky ads (page scroll in % or px, HTML element becomes visible)
  • background ads (skin ads)
  • Support for sticky ad bar
  • Support for scheduling date and time with fallback option
  • Support to show ads as soon as the GDPR consent is given
  • Support for ads in iframes
  • Anti ad blocking features – replace ads, protect content
  • Ad blocking statistics
  • Multisite options to limit settings on the sites
  • Individual post/page exception management
  • Export and import of settings
  • Support via email

Run a WordPress related blog? Have experience with AdSense? Interested in reviewing the plugin or would like to become an affiliate? Introduce yourself.

Have experience with WordPress theme or plugin translation? We are looking for translators! Contact us.

Check documentation pages for detailed description of all the features and some common settings for quick start.

You can also use shortcodes from other plugins (for example, to insert content from other plugins).

Looking for AdSense plugin with simple setup for ads at best positions?

Ad Inserter can insert ads where other plugins fail.
It’s all about the settings.

Average Rating: 5 out of 5 stars – check Ad Inserter reviews

One of the best adsense plugins
Most comprehensive Ad plugin available
Better than the old Google adsense plugin
The best WP Ad management plugin
Very flexible and excellent documentation
Excellent Ad Plugin
Easy to use and also does more than I need
Exactly what I needed to sell advertising spots
Awesome Plugin and Super Support!
Lots of options and easy to use
Crazy flexible
Great plugin that makes it simple
Superb Plugin and Support team also so good
Best in same kind of plugins
Must Have Plugin for Each WP Site
Best Ad Placement Plugin
Best Solution for Advertisement Management
Comprehensive, flexible and well supported
God bless these guys!
PRO for Free

Please support plugin development

Support the advancement of this plugin:

  • Rate it – positive ratings and reviews are a great way to show your appreciation for my work. Besides being an incredible boost to my morale, they are also a great incentive to fix any bug found in the software and to add new features for better monetization of your website.
  • Donate if Ad Inserter helps you to make money with advertising
  • Register for Ad Inserter Pro Affiliate, promote the plugin on your website and earn commission for each purchase you refer
  • Buy license for Ad Inserter Pro


  • Settings for one code block (Before content).
  • Code preview with visual CSS editor
  • Code preview with visual CSS editor - highlighted code
  • Post / Page Ad Inserter Individual Exceptions
  • Some Ad Inserter Pro features: IP address and country lists, Scheduling between dates with fallback
  • Ad Inserter plugin settings
  • Visualization of HTML tags in post
  • Visualization of positions for automatic insertion in post
  • Visualization of inserted block in post
  • Automatic insertion, Alignment and Style settings
  • Rotation code editor and banner code generator
  • Settings for automatic insertion before/after paragraphs
  • Settings for custom hooks
  • Settings automatic insertion at custom hook positions
  • Settings ad blocking detection
  • AdSense code generator
  • Complete settings for one code block (Before Paragraph)


Settings for …

Check common settings

Does Ad Inserter insert any internal ads?

No revenue sharing and no such thing as “internal ads” or “our ads” on your website. Period. What you configure is what will be inserted (+ some internal scripts for plugin features).
Ad Inserter is free, open source plugin and inserts only the code you configure (blocks, Header, Footer). The code you see is the code that will be inserted. Please check page source code before you make any conclusion.
Of course, if you configure block with some JavaScript ad code, then this code may insert some additional code or show ads. But please, don’t blame the plugin for this.
You can also use this plugin to insert code for AdSense Auto ads on each page (usually in the header). However, the exact placement of ads will be done by the ad code, not Ad Inserter!

The easiest way to check inserted blocks is to use Label blocks debugging function:

Please note that when you disable the plugin you also disable insertion of all codes and blocks you have configured.
Therefore, if your issues go away when you disable the plugin THIS DOES NOT INDICATE any issue with the plugin! You need to try to disable individual codes to see which one is causing trouble.

I have installed code for AdSense and I see ads placed at random positions.

You are probably using code for AdSense Auto ads.

Auto ads (known also as Page Level Ads) is a code that you insert on every page once and it will automatically display ads on positions chosen by the code.
The code uses Google’s machine learning to pick the best placements on your pages to show adverts.

Auto ads may not be suitable for some WordPress themes or layouts. In such cases it is easier to place ads at wanted locations by using normal AdSense code and specifying exact locations where the code should be inserted.

I have installed code for AdSense but the ad blocks are blank.

Blank ad block means that the code is inserted properly only the ad code doesn’t display ads.
Please check Ads Not Displayed for more information. You can also try other ad networks.

What is GDPR?

The GDPR (General Data Protection Regulation) is a regulation in European Union (EU) on data protection and privacy for all individuals within the EU and the European Economic Area (EEA) that was designed to harmonize data privacy laws across Europe. If you collect personal information from any EU citizen (within or outside the EU), you must first obtain explicit and unambiguous consent.

GDPR compliance: What cookies does the plugin use

Ad Inserter itself does not use cookies except for ad blocking detection when you use delayed action.

In this case 3 cookies may be used (to store pageviews and action settings): aiADB, aiADB_PV and aiADB_PR. However, no personal data is stored in the cookies.

Of course, the ads you may insert with the plugin may use own cookies – please check with ad networks for details.

How to display a GDPR compliant cookie message?

You can use any plugin for GDPR compliance / cookie consent. You can also prevent inserting ad codes and displaying ads before the consent is given – check How to show ads based on visitors’ consent.

PLEASE NOTE: Installing GDPR plugin alone does not make your site GDPR compliant. Since ads you insert may use various cookies, you may need to make sure you have necessary configurations in place. Please check next question regarding showing ads based on visitor’s consent.

How to show ads based on visitor’s consent?

Ad Inserter supports inserting ad codes (and showing ads) based on cookies or cookie values. You can define cookie conditions by black/whitelisting Url parameters (where also cookies are checked).

PLEASE NOTE: If you are using caching (very likely) you also need to set Dynamic blocks to Client-side insert (tab ⚙ / tab General) in order to check cookies in visitor’s browser and not when the page is generated.

For example, If you are using one of the following plugins for the consents you need to whitelist the following cookie and value in Url parameter list:

  • GDPR Cookie Consent – Whitelist viewed_cookie_policy=yes
  • Cookie Notice for GDPR – Whitelist cookie_notice_accepted=true
  • Cookie Consent – Whitelist catAccCookies=1
  • Quantcast Choice or any other solution based on IAB TCF 2.0 – For Google ads (AdSense) whitelist
    euconsent-v2[vendor][consents][755]=true && euconsent-v2[purpose][consents][1]=true, euconsent-v2[gdprApplies]=false

Make sure Dynamic blocks are set to Client-side insert (tab ⚙ / tab General). For more details please check How to show ads based on visitors’ consent.

Will Ad Inserter work when jQuery is deferred?


Make sure Wait for jQuery is set to Enabled in general plugin settings (tab ⚙ / tab General).

How to minimize redirects?

Ad Inserter does not do any redirects, it only inserts ad codes as configured.

If you see any report (for example from GTmetrix) suggesting to minimize redirects you need to first check where the redirects are located (on which page or domain) – if they are on other (ad network) domains you don’t control, then there is nothing you can do (nobody except ad network can change this).

For details please check this page: How to optimize plugin settings

What is plugin usage tracking?

When enabled, the information regarding WordPress environment and Ad Inserter usage will be collected and sent to plugin developers (once per month and on events like plugin activation/deactivation). See detailed explanation below.

Privacy Policy – Plugin Usage Tracking

When enabled, the information regarding WordPress environment and Ad Inserter usage will be collected and sent to plugin developers (once per month and on events like plugin activation/deactivation).

This is completely optional and can be disabled at any time. So if you have opted in (by clicking Allow when asked for permission) and now you would like to disable tracking, you should go to tab ⚙ / tab General, select Disable for Plugin usage tracking and save settings.

If this setting is not available then you have not selected any option yet – tracking is disabled unless explicitly enabled by clicking Allow when asked for permission (or when this setting is set to Enable).

What data is collected: Ad Inserter version, activation status, number of active blocks, date of installation, date of last saved settings, status of review notice and remote debugging, block class name, location, website url and name, WordPress version, language, text direction, charset, number of posts, active theme and version, list of installed plugins, PHP version, server name, IP address (used to determine country), site count for multisite installations, deactivation reasons and details (if provided).

Ad Inserter is only a plugin for WordPress content management software. It works together with WordPress, other installed plugins and selected theme.

This data provides information to make the plugin to be compatible with as many environments as possible, to test the plugin with commonly used plugins and themes, to understand why users deativate (and uninstall) the plugin and to get ideas to make improvements to the plugin.

If you are not happy to reveal this information and you have opted in, simply disable usage tracking as described above.

Your decision will be respected.


October 19, 2020
With this plugin even with free version it is possible to put ads almost on any place, just needs a bit crawling in options.
October 19, 2020
Ad inserter has made it really helpful to see exactly where my ads will be placed and how! Offers numerous ad insertions & customizeable.
October 19, 2020
1. very power feature and function 2. Debuging feature very good 3. Support very Fast Very Excellent!
Read all 1,547 reviews

Contributors & Developers

“Ad Inserter – Ad Manager & AdSense Ads” is open source software. The following people have contributed to this plugin.


“Ad Inserter – Ad Manager & AdSense Ads” has been translated into 5 locales. Thank you to the translators for their contributions.

Translate “Ad Inserter – Ad Manager & AdSense Ads” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • No ad blocking detection actions for crawlers and bots
  • Fix for processing Ad Inserter shortcodes inside HTML tags
  • Few minor bug fixes, cosmetic changes and code improvements


  • Added support to insert [embed] shortcodes
  • Few minor bug fixes, cosmetic changes and code improvements


  • Few minor bug fixes


  • Improved ad blocking detection
  • Added options to delay client-side insertions at HTML element
  • Added support to check for multiple cookie values (needed for IAB TCF 2.0)
  • Added filter hooks for block processing
  • Few minor bug fixes, cosmetic changes and code improvements


  • Added support for IAB Transparency & Consent Framework 2.0
  • Added support for taxonomy for primary category
  • Added support for taxonomy for post meta data
  • Added support to invert contain/do not contain text condition for paragraph counting
  • Few minor bug fixes, cosmetic changes and code improvements


  • Added user taxonomy items for logged-in and not logged-in users
  • Added option to define tab setup delay (for the plugin settings page)
  • Added option to insert unique ad rotation options when block is inserted more than once
  • Added support for client-side device detection for AMP pages (for method Show)
  • Added support for code generator for Amazon AMP ads
  • Added support for custom tracking events (Pro only)
  • Few minor bug fixes, cosmetic changes and code improvements


  • Added option for paragraph counting to search only tag attributes for text
  • Added option to embed block Javascript code (to be loaded with Ajax calls)
  • Added support to prevent duplicate insertions when the_content filter is called more than once (experimental)
  • Added support for the client list to check for partial user agent strings
  • Added support for check of cookie object properties
  • Improved ad blocking detection
  • Viewports no longer need to be in descending width order
  • Added option to protect inserted block content (Pro only)
  • Added support for adb scripts path filter hook (Pro only)
  • Added support to export statistics data to CSV file (Pro only)
  • Few minor bug fixes, cosmetic changes and code improvements


  • Added support to disable PHP processing by PHP constant
  • Added support to repeat COUNT options
  • Added support for offset for %n paragraph number (%n@o)
  • Added support for options to skip insertion for first and last paragraphs
  • Added support for hook filter ‘ai_block_insertion_check’
  • Added support for background ads (Pro only)
  • Few minor bug fixes, cosmetic changes and code improvements


  • Added support for various shortcodes for post categories
  • Added support for various shortcodes for post tags
  • Added support for user action on click (Pro only)
  • Added support for manual loading (Pro only)
  • Few minor bug fixes, cosmetic changes and code improvements


  • Fix for exceptions list not showing all exceptions
  • Improved ad blocking detection
  • Fix for close button in preview window (Pro only)
  • Few minor bug fixes, cosmetic changes and code improvements


  • Added support for url data shortcode
  • Added warning if not all exceptions were cleared
  • Added support for MaxMind country only database (Pro only)
  • Added support for ip to country lookup filter hook (Pro only)
  • Fix for country groups in CHECK separators (Pro only)
  • Few minor bug fixes, cosmetic changes and code improvements


  • Fix for use of undefined constant warning (Pro only)


  • Added support for shortcodes to disable block insertion
  • Added support for child taxonomy list items
  • Added random parameter to Ajax requests for geolocation (Pro only)
  • Added options to define external tracking event category, action and label (Pro only)
  • Number of custom hooks increased to 20
  • Fix to prevent insertion into head section when using Rank Math plugin
  • Few minor bug fixes, cosmetic changes and code improvements


  • Added support to disable caching of block PHP code
  • Added support to pause blocks on the blocks list
  • Added support for no url parameters list item
  • Added support for client-side scheduling (Pro only)
  • Added support for server-side scheduling using W3TC (Pro only)
  • Added support for multisite:site-id taxonomy list item (Pro only)
  • Updated MaxMind GeoLite2 database download using license key (Pro only)
  • Changed settings format in the database to prevent export/import issues with MySQL/PhpMyAdmin
  • Fix for [ADINSERTER counter] shortcode not expanding inside HTML tags
  • Few minor bug fixes, cosmetic changes and code improvements


  • Fix for errors on the settings page
  • Fix for non English characters in ads
  • Fix for sticky widgets
  • Few minor bug fixes


  • Added support for VIEWPORT separator
  • Added support for viewport check in CHECK separators (Pro only)
  • Added support to show processing log on front-end
  • Added support to show link to the Ad Inserter Pro settings page on multisite Sites page (Pro only)
  • Added support to detect and prevent document.write after DOM is ready
  • Added support for scheduling hours (Pro only)
  • Added support for scheduling days in week (Pro only)
  • Added support for W3TC insertion debugging info
  • Improved Javascript code for client-side functions
  • Improved ad blocking detection
  • Default value for Wait for jQuery set to Enabled
  • Few minor bug fixes, cosmetic changes and code improvements

Earlier versions

For the changelog of earlier versions, please refer to the separate changelog.txt file.