KudoMetrics Google Preferred Sources Button – 40+ Custom Styles

By kudometricsllc

10+ active installationsVersion 2.1.1

Add a Google Preferred Source button with the official design, 40+ styles, placement, floating buttons, and display controls.

Description

Make it easy for your readers to add your website as a Preferred Source on Google.

KudoMetrics Google Preferred Sources Button lets you add a Preferred Source button anywhere on your WordPress site. Use Google’s official button design or choose from 40+ custom styles, customize the text and appearance, and control exactly where the button appears.

When a visitor clicks the button, Google’s Preferred Sources page opens, where they can choose your website as one of their preferred sources. Content from preferred sources is more likely to appear in that reader’s Top Stories, and Google says readers click through to a site about twice as often after selecting it (Google, Apr 2026).

Key features

  • Official Google button — Use Google’s official Preferred Sources button design
  • 40+ custom button styles — Choose from a wide range of ready-made designs
  • Live preview — See your button on desktop and mobile before publishing
  • Custom button text — Change the label to suit your site and audience
  • Custom site name — Insert your publication name with the {site_name} merge tag
  • Supporting text — Add a short line above or below the button, shown always, on hover or from an info (i) icon
  • Design customization — Adjust the icon, border or fill, text color, background, tooltip background, corner radius and font size
  • 12 automatic placements — Top, middle or end of articles, below the post meta, near the table of contents, in the sidebar, above comments and more
  • Floating button — Keep the button visible in a corner while visitors scroll
  • Floating triggers — Show it immediately, after a time delay or after a set scroll percentage
  • Device controls — Show automatic buttons on mobile and desktop, desktop only or mobile only, with separate text for each
  • Multiple content types — Posts, pages, homepage/blog, category, tag and author pages, search results, archives and supported custom post types
  • Per-post control — Enable or disable the button on individual posts
  • Exclusion rules — Hide the button from specific posts, pages or categories
  • Bulk controls — Enable or disable the button across existing posts at once
  • Shortcode — [kmpsbg_preferred_source_button]
  • Gutenberg block — Insert the button anywhere in the block editor
  • Widget — Add the button to any sidebar
  • Custom Google domain — Set the domain used in the Preferred Sources link
  • Open in new tab — Choose whether the Google link opens in a new tab
  • Cache-friendly — Automatically clears page cache in WP Rocket, W3 Total Cache, WP Super Cache and LiteSpeed Cache when you save settings, so changes show up right away.

40+ button styles

  • Hero cards: Dark, Light, Blue, Soft grey, Floating, Frosted glass, Editorial serif, Luxe dark.
  • Pills and chips: Dark pill, Compact pill, Duo pill, Toolbar pill, Accent chip, Small tag.
  • Minimal and outline: Quiet minimal, Soft outline, Bold outline, Material outline, Minimal underline, Ghost / glass, Inline text link, Bordered card.
  • Gradients: Gradient card, Aurora, Sunset, Gradient ring, Rainbow border card, Dark rainbow card.
  • Banners and panels: Banner strip, Split bar, Stacked promo panel, Icon panel card, Accent rail.
  • Badges and CTAs: Google-style light badge, Follow button, Soft CTA, Neon edge, Icon bubble, Elevated card, Custom solid button.

Placement options

Placement
Where the button appears

Beginning of article
Near the start of the article content

Middle of article
After a paragraph you choose

End of article
After the article content

Below post meta
Under the author, date and read-time line

Above table of contents
Before a detected table of contents

Below table of contents
After a detected table of contents

Below featured image
Under the featured image

After first heading
After the first heading in the article

Sidebar, below sharing
Below the “Share this article” box

End of sidebar
Near the end of the sidebar

Above comments
Before the comments section

Floating corner
A fixed corner of the screen while scrolling

You can turn on more than one placement at a time. Post meta, table of contents and sidebar spots are found automatically, with no CSS selector needed. Detection depends on your theme, so use the block, shortcode or widget if a spot isn’t found.

How it works

  1. Choose your button design — Open Settings → Preferred Source and pick Google’s official button or one of 40+ custom styles. The live Desktop / Mobile preview shows the button before it goes live.
  2. Customize your button — Personalize the button to fit your website:
    • Button name/text — For example, “Add as preferred on Google”
    • Site name — Add your website or publication name
    • Supporting text — Optionally add a short explanation above or below the button (always, on hover, or info icon)
      For custom styles, adjust colors, borders, background, font size, corner radius and icon visibility. With Mobile and desktop selected, you can set different text and tooltip behavior for each device.
  3. Choose where it appears — Pick one or more of the 12 automatic placements, or add a floating button that stays visible while readers scroll.
  4. Control who sees it — Choose where automatic placement should be enabled, including posts, pages, homepage/blog, categories, tags, search results, author pages, archives, and supported custom content types. You can also control visibility by device and exclude specific posts, pages, or categories. For complete manual control, use the shortcode, block, or widget.
  5. Save and publish — Save your settings and the button appears according to your display rules. Readers click it, open Google’s Preferred Sources page and select your site as a Preferred Source.

Why use KudoMetrics Google Preferred Sources Button?

Google provides the official button code (light or dark), a direct link and button images, but you have to add them to your theme yourself, and anything more takes custom development. KudoMetrics lets you control how the button looks, where it appears and who sees it, all from your WordPress dashboard.

  • More design choice — Google’s official button plus 40+ custom styles: hero cards, pills, outlines, gradients, banners and badges.
  • Placement without code — 12 automatic positions, including below the post meta, around the table of contents and in the sidebar. Spots are detected automatically, and you can run several at once.
  • A floating button that waits — Show it after a time delay or once readers scroll a set distance, so it appears when they’re engaged.
  • Copy that fits each screen — Separate desktop and mobile button text, plus supporting text shown always, on hover or behind an info icon.
  • Show it only where it belongs — Choose content types, enable per post, exclude posts, pages or categories, and bulk-update existing posts.
  • Light on your pages — Custom styles don’t load Google’s script, front-end files load only when the button is on, and saving settings clears popular page caches.
  • Free and simple — No API key, no account, and your settings are kept if you deactivate the plugin.

Before you start

Only domain-level and subdomain-level sites that already appear in Google’s source preferences tool can be selected as a preferred source. For example, example.com and news.example.com qualify, but example.com/blog does not. The plugin creates the button and link for eligible sites. It does not register your site with Google or change your eligibility.

Disclaimer

KudoMetrics Google Preferred Sources Button is an independent WordPress plugin and is not affiliated with, endorsed by, or sponsored by Google. Google and related trademarks are the property of their respective owners. Adding a Preferred Source button does not guarantee higher rankings, more traffic or inclusion in any Google Search feature.

Custom styles use an original multicolor G icon, which is plugin artwork, not a Google trademark file. The optional official button loads Google’s own script from news.google.com and is subject to Google’s terms.

External services

This plugin can load Google’s Subscribe with Google publisher script when you enable the official interactive Google button on the Design tab.

The script is loaded from https://news.google.com/swg/js/v1/publisher.js on pages where that button is shown. It renders Google’s official Preferred Sources button in the visitor’s browser. The plugin does not send your WordPress site data to Google through this script; Google’s script may collect usage data according to Google’s policies when it runs in the visitor’s browser.

This service is provided by Google LLC: Terms of Service, Privacy Policy.

Custom button styles link to https://www.google.com/preferences/source (or your configured domain) so visitors can open Google’s Preferred Sources page. Those links are opened in the visitor’s browser only when they click the button; no server-side request is made by the plugin to Google for custom styles.

Installation

Install from your WordPress dashboard

  1. Go to Plugins → Add New Plugin.
  2. Search for “KudoMetrics Google Preferred Sources Button”.
  3. Click Install Now, then Activate.

Install manually

  1. Download the plugin ZIP from WordPress.org.
  2. Go to Plugins → Add New Plugin → Upload Plugin, choose the ZIP and click Install Now. Or upload the folder to /wp-content/plugins/kudometrics-preferred-source-button-for-google.
  3. Activate the plugin from the Plugins screen.

Configuration

  1. Go to Settings → Preferred Source.
  2. On the Design tab, choose Custom or Google official, pick a style, and set the button text, supporting-text trigger and devices.
  3. On the Display tab, turn on “Show the button on your site”, choose who sees it, pick content types and select your placements.
  4. Save your settings, then check the button on a live post on desktop and mobile.

Add the button manually (optional)

  • Gutenberg block: In the editor, search for “Preferred Source Button” and insert the block.
  • Shortcode: Add [kmpsbg_preferred_source_button] anywhere shortcodes are supported.
  • Widget: Add the Preferred Source Button widget to a sidebar under Appearance → Widgets.

FAQ

What is a Google Preferred Source?

Preferred Sources is a Google Search feature that lets readers choose sites they want to see more of. Content from a selected site is more likely to appear in that reader’s Top Stories with a “preferred” badge.

What does this plugin do?

It adds a Preferred Source button to your WordPress site. Visitors click it, go to Google, and can add your website as a preferred source.

Is the plugin free?

Yes. It is free to download from the official WordPress.org plugin directory.

Does it register my site with Google?

No. It builds the google.com/preferences/source link for your domain, in the format Google documents for site owners. Whether your site can be selected depends on Google’s own criteria.

Does clicking the button add my site automatically?

No. The button opens Google’s Preferred Sources page for your domain. The reader completes the selection with Google.

Does the plugin include Google’s official button?

Yes. Use Google’s official interactive Preferred Sources button or choose from 40+ custom styles.

Can I customize the button design?

Yes. Change the button text, site name, colors, background, border, font size, corner radius, icon visibility and supporting text, with a live preview before you publish.

How do I show the button below the post meta, table of contents or in the sidebar?

On the Display tab, tick Below the post meta, Above or Below the table of contents, Sidebar below Share this article, or End of the sidebar. The plugin finds those spots automatically, with no CSS selector needed.

How do I show the button on every post?

Turn on Show the button on your site, choose All posts, tick Post (and any other content types), pick at least one placement and save.

How do I show the button on only some posts?

Choose Choose per post. Open a post, find the Preferred Source Button box in the editor sidebar, set Show on this post to Enable and update.

How do I hide it on one post or page?

Enter that item’s ID under Exclude specific posts and pages. For example, 1000 hides post 1000 only. You can also tick a category to hide the button on every post in it.

Can I show the button only on mobile?

Yes. Automatic placements can show on mobile and desktop, desktop only or mobile only. With both, you can set different button text and tooltip behavior for each.

Can I use a floating Preferred Source button?

Yes. Choose its corner and show it immediately, after a scroll percentage or after a time delay. These triggers apply only to the floating button, not to in-content buttons.

Is there a shortcode?

Yes. Use [kmpsbg_preferred_source_button] anywhere shortcodes are supported.

Can I change the destination domain?

Yes. It uses your site’s domain by default, and you can override it in Settings, for example on a staging or subdomain setup.

Do I need a Google API key?

No. The button works without a Google API key or account connection.

Does adding the button improve my Google rankings?

No. Using the plugin or being selected as a Preferred Source does not guarantee higher rankings, more traffic or visibility in Google Search.

Does it work with caching plugins?

Yes. When you save settings, it automatically clears page cache in WP Rocket, W3 Total Cache, WP Super Cache, LiteSpeed Cache and similar plugins, if installed. CDN caches, like Cloudflare, may need a manual purge.

What happens if I deactivate or uninstall the plugin?

Deactivating keeps your settings. Uninstalling deletes plugin settings, widget settings and per-post enable/disable data.

Is this plugin affiliated with Google?

No. It is an independent plugin by KudoMetrics and is not affiliated with, endorsed by or sponsored by Google.

Screenshots

Changelog

2.1.1

  • Performance & Architecture: Refactored core codebase into modular components under includes/.
  • Enhanced button placement detection, styling controls, and stability improvements.

1.7.46

  • Fix: Prevented nested form submission conflicts on admin settings bulk actions.
  • Fix: Improved custom CSS selector saving and JSON synchronization in settings.
  • Fix: Allowed wildcard (*) characters in custom CSS selector validation.
  • Fix: Enhanced button placement detection for themes with hero/slide sections and Genesis child themes.
  • Fix: Cleaned up legacy placement settings flags.

1.7.45

  • Moved settings-page admin CSS from inline style to assets/css/admin.css (Plugin Check).

1.7.44

  • Moved settings-page admin JavaScript from inline script to assets/js/admin.js (Plugin Check).

1.7.43

  • Bulk post actions now use POST via admin-post.php instead of GET links.
  • Added post revision/autosave guard on per-post meta save.
  • Block editor script translations, directory index.php files, and minor Plugin Check fixes.

1.7.42

  • Renamed to KudoMetrics Preferred Source Button for Google (slug: kudometrics-preferred-source-button-for-google).
  • Prefixed functions, options, shortcode, block, and script handles with kmpsbg_ (6 characters).
  • Documented Google external services in readme (Terms of Service and Privacy Policy links).
  • Fixed admin bulk-action URLs to use the new settings page slug.