Confirm your site qualifies.
The built-in eligibility checker validates your setup and warns about subdirectories, localhost and staging addresses that Google cannot recognise as eligible sources.
A WordPress pluginfrom Opace Free WordPress plugin · GPLv2+ · v1.1.2 · Awaiting WordPress.org review
Add as Preferred Source Button, Popup & Analytics for Google (SEO & AI Overviews)
Put Google's official one-click Preferred Sources popup anywhere on your WordPress site, let smart placement find the position that earns clicks, and measure the results without a single invented number.
Built by the Opace WordPress development team SettingsPlacementAnalyticsHelp
Smart placement Rotates 5 positions · serves the winner 90/10
| Position | Impr. | Clicks | CTR |
|---|---|---|---|
| After intro | 4,120 | 96 | 2.3% |
| End of post ★ | 3,988 | 122 | 3.1% |
| Floating banner | 2,410 | 41 | 1.7% |
The complete kit
One plugin, two free tools, all open.
Everything in the Add as Preferred Source suite works together: check eligibility, generate code for any platform, or let the plugin do it all on WordPress.
The dedicated Preferred Source Checker for Chrome is now available publicly in the Chrome Web Store. Its source and issue tracker remain public on GitHub.
How it works
Check. Place. Measure.
Three steps from activation to a button that earns opt-ins, with every claim on the analytics screen measured, not modelled.
Put the button where readers act.
Block, shortcode, widget, floating banner or auto-placement, or let smart placement rotate five positions and learn.
See clicks, honestly counted.
Impressions, clicks and CTR per position, plus a GA4 event. Labelled clicks throughout, because Google reports no completions.
The button, popup and deeplink all use only the surface documented in Google's official Preferred Sources documentation.
See the complete suite
Three tools, one route from eligibility to live code.
These are genuine screens from the browser-based eligibility checker, multi-platform button generator and WordPress plugin. Select an image to inspect it at full size.
View larger ↗ 
View larger ↗ 
View larger ↗ What's in the plugin
Placement, persuasion and proof.
Every feature exists to earn the reader's opt-in or to report what actually happened. Nothing is padded.
01
Smart placement
Five positions. One learns to win.
Smart placement rotates five content-aware positions, from after your opening insight to the end of the post, and records aggregate impressions and clicks for each. Once a position proves itself, it's served 90% of the time while the remaining 10% keeps testing the field.
- Learning uses aggregate counts only, never reader profiles.
- Positions are content-aware, so the button lands beside real paragraphs, not in gaps.
- Turn it off any time and pin one position manually.
- 1After first insightTesting
- 2Mid-articleTesting
- ★End of postWinner · 90%
- 4Quiet footer linkTesting
- 5Floating bannerTesting
02
Every placement route
Block, shortcodes, widget, banner.
Use the Gutenberg block, the [preferred_source_popup],
[preferred_source_button] or [psp_button] shortcodes, a
widget, a floating banner or automatic in-content placement.
- Works in classic and block themes, page builders included via shortcode.
- A Help & shortcodes screen documents every route inside wp-admin.
03
CRO triggers
Ask at the right moment.
Show the prompt on scroll depth, after a time delay, on exit intent or to returning visitors, and suppress it automatically once a reader has clicked.
- Triggers combine, so you can ask engaged readers only.
- Post-click suppression stops the plugin nagging people who already acted.
04
Honest analytics
Impressions, clicks and CTR. That's all.
Per-position statistics and an optional GA4 event per click. Google's SDK has no completion callback, so every figure is labelled as clicks, never conversions.
- No invented "preferred source counts" anywhere in the interface.
- Counts are aggregate; no reader-level tracking is stored.
05
Eligibility and consent
Checked before it ships, consented before it loads.
The built-in checker warns when a site can't qualify (subdirectories), and GDPR two-click mode makes the first request to Google happen only after the reader's explicit click.
- Automatic deeplink fallback keeps the button working when scripts are blocked.
06
Built for networks
Multisite defaults and white-label.
Network administrators set defaults once across a multisite install, and a white-label filter lets agencies present the admin screens under their own name.
NETNetwork defaultsConfigure once, apply across every site in the network WLWhite-label filterRename the admin screens for client-facing installs ✓Plugin CheckPasses the official WordPress Plugin Check with zero errors GPLOpen licenceGPLv2 or later, with the full source public on GitHub
Honest by design
Clicks, never conversions.
The same transparency rules as the rest of the Preferred Sources suite.
- 01No completion data exists. Google's SDK reports nothing back when a reader finishes the flow, so the plugin counts clicks and says so on every screen.
- 02Documented API only. The button, popup and deeplink use Google's published surface. Nothing proprietary, nothing undocumented.
- 03Aggregate counts only. Smart placement learns from totals per position, not from profiles of individual readers.
- 04Consent before contact. Two-click mode delays any request to Google until the reader explicitly acts.
- 05Fails safely. When Google's script is blocked, readers get the documented deeplink instead of a dead button.
- 06No ranking promises. Preferred Sources is per-reader personalisation. The plugin helps you ask for the opt-in; it claims nothing more.
Current release
WordPress v1.1.2 · Awaiting Review
The whole suite in one install: the official popup button, a Gutenberg block, three shortcodes, a floating banner, smart placement, CRO triggers and honest click analytics. WordPress.org received the v1.1.2 submission and its automated scan passed; the submission is awaiting review and is not public in the directory yet. Requires WordPress 6.2+ and PHP 7.4+.
WordPress.org status: v1.1.2 was submitted on 28 August 2026. The automated scan reports Pass and the current state is Awaiting Review. Submission is not approval or publication, so there is no public directory URL yet. GPLv2 or later.
WordPress installation
01 Obtain the v1.1.2 package from Opace
02 Plugins → Add New → Upload Plugin
03 Activate, then open Settings → Preferred Source
04 Run the built-in eligibility check
05 Pick a placement, or turn on Smart placement
06 Watch clicks arrive in AnalyticsQuestions before installing
Placement, privacy and release status.
What does the plugin actually add to my site?
Google's official Preferred Sources popup button, rendered by Google's own publisher.js script. When a reader clicks it, Google's popup opens on your page and they can add your site as a preferred source in a couple of clicks. If the script is blocked, the plugin automatically falls back to the documented deeplink to Google's preferences page, so the button never dead-ends.
Where can I place the button?
Anywhere: a Gutenberg block, three shortcodes ([preferred_source_popup], [preferred_source_button] and [psp_button]), a widget, a floating banner, or automatic placement inside your content. Smart placement can also choose the position for you.
What is Smart placement?
An optional mode that rotates five content-aware positions, learns from aggregate click statistics, and then serves the best performer 90% of the time while still testing alternatives with the other 10%. It uses counts, not personal data.
Can it tell me how many readers actually became preferred sources?
No, and neither can anything else: Google's SDK provides no completion callback. The plugin measures impressions, clicks and CTR, and can send a GA4 event per click, and everything in the interface is labelled as clicks, never conversions.
Is my site eligible for Preferred Sources?
Domains and subdomains qualify; subdirectories don't. The plugin includes an eligibility checker that warns about subdirectory, localhost and staging setups, and our free online checker explains the published domain rules before you install anything.
How does the GDPR two-click mode work?
With two-click mode on, no request is made to Google when the page loads. The reader sees a neutral first button; only after they click it does the plugin load Google's script and show the real popup button, so the Google request happens on explicit interaction.
Does it work on multisite?
Yes. Network administrators can set defaults across the network, and a white-label filter lets agencies rename the admin screens for clients.
When will it be on WordPress.org?
WordPress.org received the version 1.1.2 submission on 28 August 2026. Its automated scan passed and the submission is Awaiting Review. Submission is not publication, so there is no public WordPress.org directory page yet; the source remains public on GitHub.
Is the Preferred Source Checker Chrome extension available?
Yes. Version 1.0.0 is published publicly in the Chrome Web Store. It audits eligibility, publisher SDK loading, button setup and fallback links on the page you are viewing. Its source remains public on GitHub.
Does the button improve my rankings?
No. Preferred Sources is per-reader personalisation, not a ranking signal. Readers who prefer your site see more of it in Top Stories, Discover and AI Overviews, and Google reports they click through roughly twice as often. The plugin's job is making that opt-in easy to ask for.
Created by Opace Digital Agency
Need help with WordPress or visibility?
Opace builds and supports practical WordPress and SEO systems from Birmingham for organisations across the UK and internationally. This plugin comes from that client work.
The no-code route to Preferred Sources
Ask every reader. Count every click.
See the live route Add Opace as a preferred source in Google. This documented deeplink opens Google's preferences page with opace.agency filled in. Open Google Preferred Sources ↗ Before you install Check your domain is the right shape for Preferred Sources. Ten seconds, in your browser, with Google's own tool for the final word. Open the eligibility checker → Not on WordPress? Generate the button code for any platform instead. Copy-paste snippets for plain HTML, Elementor, Webflow, Shopify, Astro and React. Open the button generator →
Browse all Opace tools Related open-source projects: WordPress plugin, framework packages and the Chrome Site Checker with source on GitHub. Browse every Opace project on the Opace GitHub hub.
This plugin is independently developed by Opace Digital Agency and is not affiliated with, endorsed by or sponsored by Google. Google and the Google logo are trademarks of Google LLC. Licensed under GPLv2 or later.