Skip to main content

Ad Management

PaywallWP Pro includes a built-in ad management system that displays advertisements to non-subscribers while hiding them for paying members. This "ad-free experience" is a common premium benefit.

How It Works​

  1. Configure ad zones with your ad code
  2. Set visibility rules based on subscription level
  3. Subscribers see clean, ad-free content
  4. Non-subscribers see ads in designated zones

Benefits​

For Publishers:

  • Monetize non-paying visitors
  • Incentivize subscriptions
  • Manage ads centrally

For Subscribers:

  • Ad-free reading experience
  • Faster page loads
  • Premium feel

Ad Zones​

PaywallWP Pro supports multiple ad placement zones:

ZonePlacementShortcode Required
Auto AdsPage head (script injection)No (automatic)
HeaderTop of pageYes
SidebarWidget areaYes
In-ContentWithin post bodyNo (automatic)
After ContentAfter post contentNo (automatic)
FooterBottom of pageYes

Automatic Zones​

  • Auto Ads — Scripts injected in page <head> for ad networks that auto-place ads (like AdSense Auto Ads)
  • In-Content — Ads inserted at specific paragraph positions within posts
  • After Content — Ads appended after post content

No shortcodes needed for these zones.

Manual Zones​

Header, Sidebar, and Footer zones require shortcodes:

[paywp_ad zone="header"]
[paywp_ad zone="sidebar"]
[paywp_ad zone="footer"]

Configuration​

Enable Ad System​

  1. Go to PaywallWP → Settings → Ads
  2. Toggle Enable Ads to on
  3. Configure Hide Ads for Subscribers
  4. Set Minimum Access Level to hide ads
  5. Save Settings

Configure Ad Zones​

For each zone:

  1. Enable the zone
  2. Paste your ad code (HTML/JavaScript)
  3. Set position options (if available)
  4. Save

Ad Code Example​

Paste your ad network code directly:

<!-- Google AdSense -->
<ins
	class="adsbygoogle"
	style="display:block"
	data-ad-client="ca-pub-XXXXXXXXXX"
	data-ad-slot="XXXXXXXXXX"
	data-ad-format="auto"
></ins>
<script>
	(adsbygoogle = window.adsbygoogle || []).push({});
</script>

Visibility Settings​

Hide Ads for Subscribers​

SettingDescription
Hide AdsEnable/disable ad hiding
Minimum LevelAccess level required to hide ads

Example configurations:

Access LevelWho Sees Ads
1All subscribers ad-free
3Only Level 3+ subscribers ad-free
5Only Premium/VIP ad-free

Per-Plan Ad Settings​

You can make "ad-free" a feature of specific plans:

Basic Plan (Level 2):

  • Access to basic content
  • Still sees ads

Premium Plan (Level 5):

  • Access to all content
  • Ad-free experience

Set the minimum level to 5, and only Premium subscribers get ad-free.

In-Content Ads​

Automatic Placement​

In-content ads are inserted automatically:

SettingDescription
PositionAfter X paragraphs
RepeatInsert multiple times
Min Content LengthOnly for longer posts

Configuration​

  1. Go to Settings → Ads → In-Content
  2. Set Insert After Paragraph (e.g., 3)
  3. Enable Repeat to insert multiple times
  4. Set spacing between ads
  5. Save

Using the Shortcode​

Basic Usage​

[paywp_ad zone="sidebar"]

In Widgets​

Add to a Text widget or Shortcode widget:

[paywp_ad zone="sidebar"]

In Theme Templates​

<?php echo do_shortcode('[paywp_ad zone="header"]'); ?>

Multiple Ad Networks​

You can use different ad networks per zone:

ZoneAd Network
HeaderGoogle AdSense
SidebarCustom sponsor
In-ContentNative ads
FooterAffiliate banner

Best Practices​

Ad Placement​

  1. Don't Overload — 3-4 ads per page maximum
  2. Above the Fold — At least one ad visible immediately
  3. Natural Flow — Ads shouldn't interrupt reading
  4. Mobile First — Test ad appearance on mobile

Performance​

  1. Lazy Load — Use lazy loading for below-fold ads
  2. Async Scripts — Load ad scripts asynchronously
  3. Minimize Count — Fewer ads = faster pages

User Experience​

  1. Clear Labeling — Ads should be identifiable
  2. Non-Intrusive — Avoid popups and interstitials
  3. Consistent Sizes — Use standard ad dimensions
  4. Quality Ads — Avoid deceptive or low-quality ads

Ad-Free as a Selling Point​

Market ad-free as a premium benefit:

On Pricing Page​

Premium Plan Features:
✅ Access to all content
✅ No advertisements
✅ Faster page loads
✅ Clean reading experience

On Paywall​

Subscribe for ad-free reading

Testing Ads​

Test as Non-Subscriber​

  1. Open incognito browser
  2. Visit your site
  3. Verify ads appear in correct zones

Test as Subscriber​

  1. Log in as a test subscriber
  2. Verify ads are hidden
  3. Check console for errors

Common Ad Networks​

Test with these popular networks:

  • Google AdSense
  • Media.net
  • Ezoic
  • Mediavine
  • AdThrive

Troubleshooting​

Ads Not Showing​

  • Verify ad zone is enabled
  • Check ad code is valid
  • Disable ad blockers for testing
  • Check console for JavaScript errors

Ads Showing for Subscribers​

  • Verify subscriber access level
  • Check minimum level setting
  • Clear cache
  • Log out and log in again

Ads Breaking Layout​

  • Check ad code for errors
  • Verify responsive settings
  • Test on multiple screen sizes
  • Use appropriate ad sizes

Ad Blockers​

Some users use ad blockers. Options:

  1. Accept It — Ad-free subscribers don't care
  2. Detect — Show message asking to whitelist
  3. Paywall — Offer subscription as alternative

Analytics​

Track ad performance:

MetricWhy It Matters
Ad ImpressionsRevenue potential
Click RateAd engagement
Revenue per UserCompare to subscription value
Ad-Free ConversionsSubscribers motivated by ads

Next Steps​