Independent publishers help readers understand their communities, interests, and the events shaping everyday life.<\\\/p>
A preferred-source invitation gives readers a clear next step at the end of an article without interrupting the story.<\\\/p>' ) ); } flush_rewrite_rules(); ?>\"},{\"step\":\"installPlugin\",\"pluginData\":{\"resource\":\"wordpress.org\\\/plugins\",\"slug\":\"publisher-reach\"},\"options\":{\"activate\":true}}]}"}},"all_blocks":{"publisher-reach\/preferred-sources":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"publisher-reach\/preferred-sources","version":"1.0.0","title":"Preferred Source Button","category":"widgets","icon":"star-filled","description":"Invite readers to add this site as a preferred source on Google.","keywords":["preferred source","google","publisher"],"textdomain":"publisher-reach","editorScript":"file:.\/index.js","editorStyle":"file:.\/editor.css","style":["publisher-reach-frontend","file:.\/style.css"],"attributes":{"preset":{"type":"string","default":"inherit"},"label":{"type":"string","default":""},"heading":{"type":"string","default":""},"body":{"type":"string","default":""},"alignment":{"type":"string","default":"inherit"},"theme":{"type":"string","default":"inherit"},"language":{"type":"string","default":"inherit"},"buttonDesign":{"type":"string","default":"inherit"},"badgeTheme":{"type":"string","default":"inherit"},"showIcon":{"type":"boolean"},"fullWidthMobile":{"type":"boolean"}},"supports":{"anchor":true,"align":["wide","full"],"className":true,"html":false,"spacing":{"margin":true}}}},"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3667963,"resolution":"1","location":"assets","locale":"","width":1425,"height":990},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3667963,"resolution":"2","location":"assets","locale":"","width":1425,"height":990},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3667963,"resolution":"3","location":"assets","locale":"","width":1440,"height":1000},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3667963,"resolution":"4","location":"assets","locale":"","width":375,"height":812}},"screenshots":{"1":"Publish an official Preferred Sources invitation inside an article with editable publisher copy.","2":"Choose the official badge or custom CTA and review changes in the live Desktop\/Mobile preview.","3":"Add the Preferred Source Button block and adjust its design, badge, preset, and copy in the editor.","4":"Keep the official badge compact, readable, and overflow-free on mobile articles."}},"plugin_section":[],"plugin_tags":[1602,3019,151844,271892,262467],"plugin_category":[],"plugin_contributors":[272160],"plugin_business_model":[],"class_list":["post-358723","plugin","type-plugin","status-publish","hentry","plugin_tags-call-to-action","plugin_tags-google-search","plugin_tags-gutenberg-block","plugin_tags-preferred-sources","plugin_tags-publisher-tools","plugin_contributors-mdotk","plugin_committers-mdotk"],"banners":{"banner":"https:\/\/ps.w.org\/publisher-reach\/assets\/banner-772x250.png?rev=3667963","banner_2x":"https:\/\/ps.w.org\/publisher-reach\/assets\/banner-1544x500.png?rev=3667963","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/publisher-reach\/assets\/icon-128x128.png?rev=3667963","icon_2x":"https:\/\/ps.w.org\/publisher-reach\/assets\/icon-256x256.png?rev=3667963","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/publisher-reach\/assets\/screenshot-1.png?rev=3667963","caption":"Publish an official Preferred Sources invitation inside an article with editable publisher copy."},{"src":"https:\/\/ps.w.org\/publisher-reach\/assets\/screenshot-2.png?rev=3667963","caption":"Choose the official badge or custom CTA and review changes in the live Desktop\/Mobile preview."},{"src":"https:\/\/ps.w.org\/publisher-reach\/assets\/screenshot-3.png?rev=3667963","caption":"Add the Preferred Source Button block and adjust its design, badge, preset, and copy in the editor."},{"src":"https:\/\/ps.w.org\/publisher-reach\/assets\/screenshot-4.png?rev=3667963","caption":"Keep the official badge compact, readable, and overflow-free on mobile articles."}],"raw_content":"\n
Publisher Reach helps WordPress publishers add polished Google Preferred Sources invitations without hand-coding the integration or restyling every placement.<\/p>\n\n
Choose Google's official localized badge or create a branded CTA with editable text, a site logo, theme-aware colors, and responsive layouts. Publish it with the block, shortcode, automatic article placement, or an optional floating prompt.<\/p>\n\n
The complete plugin is free. There is no Publisher Reach account, API key, paid plan, telemetry, or artificial feature limit.<\/p>\n\n
One integration mode applies across the document. The selected-design and native modes request Google's library when the first Publisher Reach surface renders. Direct-link mode is the privacy-first choice when no pre-click Google request is wanted. See External Services<\/strong> before enabling a mode.<\/p>\n\n Add the Preferred Source Button<\/strong> block, or use:<\/p>\n\n Optional attributes are Example:<\/p>\n\n Publisher Reach does not register or approve a site or confirm that a reader completed Google's flow. It cannot guarantee selection, visibility, placement, traffic, or rankings. Google controls eligibility and the Preferred Sources service. Only domains and subdomains are eligible; a subdirectory such as Publisher Reach is independent and is not affiliated with, sponsored by, or endorsed by Google. Google marks belong to Google LLC.<\/p>\n\n Publisher Reach has no telemetry, advertising, or author connection. Settings stay in WordPress. The optional prompt stores only a session flag or local timestamp in the visitor's browser; it is not analytics. See Publisher Reach can connect visitors to Google's Preferred Sources service. Google controls that service, including its availability, eligibility decisions, interface, completion state, and results.<\/p>\n\n In the selected-design and native modes, Publisher Reach requests Google's Preferred Sources library from:<\/p>\n\n It is requested only after the first non-direct-link Publisher Reach surface renders. Google may process ordinary request data such as IP address, browser, referrer, and publication domain under its policies.<\/p>\n\n In direct-link mode, Publisher Reach creates a local link in this form:<\/p>\n\n Google is contacted only after the visitor follows that link.<\/p>\n\n Service documentation: https:\/\/developers.google.com\/search\/docs\/appearance\/preferred-sources<\/p>\n\n Google Terms of Service: https:\/\/policies.google.com\/terms<\/p>\n\n Google Privacy Policy: https:\/\/policies.google.com\/privacy<\/p>\n\n Publisher Reach does not send telemetry, site configuration, or visitor analytics to the plugin authors.<\/p>\n\n Human-readable source is under A working button does not prove eligibility or selection. Check Google's source preferences tool separately.<\/p>\n\n\n No. Google controls eligibility. Only domains and subdomains are eligible, not subdirectories.<\/p><\/dd>\n No. Publisher Reach cannot guarantee selection, visibility, placement, traffic, or rankings.<\/p><\/dd>\n The selected-design and native modes request Google's script where a CTA renders. The direct-link mode makes no pre-click Google request; Google is contacted only after the visitor follows the link.<\/p><\/dd>\n It contains only the validated WordPress Home URL hostname as Google's No author telemetry is sent. Prompt dismissal stays in browser local or session storage. Google may process ordinary request data when its service or link is used.<\/p><\/dd>\n The selected-design and native modes require Google's script and interface. Publisher Reach never weakens Content Security Policy. Direct-link mode needs no external script or iframe.<\/p><\/dd>\n Settings are per site. Network activation does not establish eligibility, and subdirectory paths are not separate source identities.<\/p><\/dd>\n Missing logos are omitted. Theme mode inherits the surrounding article when no usable Global Styles palette exists. Custom logos and fixed colors remain available in Design<\/strong>.<\/p><\/dd>\n Yes. Choose Official Google badge<\/strong> in Design<\/strong>. Publisher Reach includes Google's supplied light, dark, localized, and Retina artwork. Editable publisher copy and logos remain visually separate from the unmodified badge.<\/p><\/dd>\n With Delete data on uninstall<\/strong> enabled (the default), uninstall removes only Publisher Reach settings and suppression metadata, never posts. Browser-stored prompt dismissals cannot be cleared server-side.<\/p><\/dd>\n\n<\/dl>\n\n\nBlock and shortcode<\/h4>\n\n
[publisher_reach]\n<\/code><\/pre>\n\nlabel<\/code>, heading<\/code>, body<\/code>, preset<\/code>, align<\/code>, theme<\/code>, lang<\/code>, design<\/code>, badge_theme<\/code>, icon<\/code>, and mobile_full<\/code>. They inherit the global settings unless overridden. URLs, HTML, CSS, and executable code are rejected.<\/p>\n\n[publisher_reach heading=\"Make us a preferred source\" body=\"See more from our newsroom in Google Search.\" align=\"center\" design=\"google_badge\" badge_theme=\"auto\" preset=\"compact\"]\n<\/code><\/pre>\n\nImportant boundaries<\/h4>\n\n
example.com\/news<\/code> is not a separate source.<\/p>\n\nPrivacy<\/h4>\n\n
PRIVACY.txt<\/code>, THIRD_PARTY_NOTICES.txt<\/code>, and External Services<\/strong> below.<\/p>\n\nExternal Services<\/h3>\n\n
https:\/\/news.google.com\/swg\/js\/v1\/publisher.js\n<\/code><\/pre>\n\nhttps:\/\/www.google.com\/preferences\/source?q=example.com\n<\/code><\/pre>\n\nDevelopment<\/h3>\n\n
src\/<\/code>. Run npm ci && npm run build<\/code> with a supported Node.js version to reproduce generated assets from scripts\/build-assets.mjs<\/code> and package-lock.json<\/code>. Google's unmodified Preferred Sources badge images and their source\/licence record are under resources\/<\/code>; no third-party runtime code, font, or copied Google JavaScript is bundled.<\/p>\n\n\n\n
\n
Does Publisher Reach make my site eligible for Preferred Sources?<\/h3><\/dt>\n
Does it guarantee Google rankings or traffic?<\/h3><\/dt>\n
When does a visitor's browser contact Google?<\/h3><\/dt>\n
What does the direct link contain?<\/h3><\/dt>\n
q<\/code> value, never a post path, shortcode URL, HTML, or visitor data.<\/p><\/dd>\nDoes the plugin track visitors?<\/h3><\/dt>\n
What should I know about Content Security Policy?<\/h3><\/dt>\n
What should I know about multisite?<\/h3><\/dt>\n
What happens if my theme has no Site Logo or Global Styles colors?<\/h3><\/dt>\n
Can I use Google's official Preferred Sources badge?<\/h3><\/dt>\n
What happens on uninstall?<\/h3><\/dt>\n
1.0.0<\/h4>\n\n
\n