Implementation brief · SEO
Preferred Sources creates a reader return path, not a ranking shortcut
Google's new button can turn a satisfied visit into a durable source preference. The useful implementation respects what the feature can change and what it cannot promise.
- The choice belongs to the readerSelecting a site makes its content more likely to appear for that user in Top Stories and can add a preferred badge in supported AI experiences.
- The standard button needs only two HTML additionsGoogle supplies the library and an automatically localized control, then returns the reader to the page after the preference flow.
- Eligibility stops at a domain or subdomainA publication section in a subdirectory cannot become a separate preferred source, so information architecture now shapes the available choice.
- Placement should follow evidence of valueThe strongest prompt appears after a useful article or during a natural loyalty moment, not as an interrupt before the reader knows the publication.
Google updated its Search documentation on 20 August 2026 with a custom interactive button for Preferred Sources. A publication can now invite a reader to choose it as a source without sending that reader through a disconnected settings journey. The recommended implementation opens Google's preference flow and brings the reader back to the page where the decision began.
That sounds like a small interface change. Strategically, it moves one part of discovery from a purely inferred relationship to an explicit reader choice. The button does not guarantee a position, create a site-wide ranking boost or replace editorial quality. It creates a return path that can make a chosen publication more visible to one person in Top Stories and visibly preferred in supported AI experiences.
Google turns a settings action into an on-page audience moment
The new custom button can be embedded in a publication, localized automatically and configured to return the reader to the page after the preference is saved.
A preferred source is personal state, not universal authority
Google says content from a selected source is more likely to appear in Top Stories for that user and can be highlighted with a preferred badge in AI Mode and AI Overviews. The subject of that sentence matters. The effect follows the person who made the choice; it is not a global endorsement applied to every searcher.
The distinction prevents two common overclaims. First, a publisher cannot buy or declare preferred status on behalf of an audience. Second, implementing the button is not required for a site to appear as a preferred source. Google presents the integrations as ways to help readers find and select the publication, not as a technical eligibility requirement or ranking factor.
A person chooses a publication
The preference expresses an ongoing source relationship and can shape how that person's supported Search surfaces highlight the source.
Visibility may increase for that reader
Google does not promise a fixed position, a universal ranking lift or inclusion whenever the publication covers a query.
The recommended implementation has a deliberately small surface
The standard version adds Google's publisher library, preferably in the document head, and a marked container where the control should appear. Google renders the button, translates it according to the browser language and supports light or dark presentation. A publication can override the language, but the automatic default reduces the maintenance burden for multilingual audiences.
<script async src="https://news.google.com/swg/js/v1/publisher.js"></script>
<div google-add-preferred-source-btn></div>Two additions create the localized return flow
The library discovers the marked element, renders Google's control and handles the preference journey. The publisher chooses the moment and location; Google controls the source-selection interface.
The simplicity is useful because it keeps the promise narrow. The page does not need to imitate a Google setting, collect a second consent state or guess whether the user completed the action. For custom interfaces, Google also documents ES module and callback-queue implementations that trigger the same flow from a publisher-owned control. A deeplink remains available when a CMS cannot run the interactive button.
The Return-to-Source Circuit is the real conversion model
The button works only after several independent conditions align. Treating it like a generic subscribe call to action misses the sequence. A publication must be discoverable in Google's source preferences tool, the reader must have received enough value to care, the prompt must preserve rather than interrupt that value, and the preference flow must return the person to the original context.
Signature module · The Return-to-Source Circuit
A durable preference begins after the article has earned the request
The circuit separates technical eligibility from editorial value and makes the return to the page part of the conversion.
The domain or subdomain appears in Google's source preferences tool.
The reader reaches a point where the publication has demonstrated a reason to return.
The Google flow records the user's source preference, not a publisher claim.
The reader returns to the article instead of losing the session to a settings detour.
Placement should follow a loyalty signal
A preference prompt at the top of a first visit asks for trust before supplying evidence. Better placements sit after a complete argument, beside a recurring beat or within a signed-in loyalty area. The correct moment depends on the publication, but it should be explainable in reader terms rather than measured only by button exposure.
The best prompt follows a proof of editorial value
Use the end of a strong article, a topic hub or a return-reader milestone. Avoid overlays that obscure the lead, prompts before the first meaningful paragraph and repeated interruptions on every pageview. A source preference is a relationship signal, so the interface should feel closer to saving a publication than dismissing a promotion.
Domain architecture now sets the preference boundary
Google limits eligibility to domains and subdomains. A publication at news.example.com can be selected independently, while example.com/news cannot. That does not mean every editorial section should move to a subdomain. It means a publisher with genuinely independent brands or desks must include source identity in the architecture decision instead of treating the URL boundary as purely technical.
This is separate from the control plane covered in our analysis of Google-Extended and Search AI. Preferred Sources records a user's relationship with a publication; it does not govern crawling, training or Search AI participation. It is also different from Search Console platform properties, which measure discovery on external social and video platforms rather than create a source preference.
Choose the integration that matches the publishing stack
| Implementation | Best fit | What the publisher controls |
|---|---|---|
| Standard JavaScript button | Most publication pages | Placement, light or dark theme and optional language override |
| Advanced JavaScript flow | Custom UI, apps and framework milestones | Own trigger design and timing while retaining Google's preference flow |
| Deeplink | Restricted CMS, newsletters and social promotion | Link or image treatment leading to Google's source preferences tool |
Measurement should separate exposure from completed preference
The publisher can measure where the prompt appeared, whether a user invoked it and whether the page regained focus after the flow. That is not the same as proving that Google saved the preference or attributing later Top Stories exposure to one click. The implementation should avoid inventing a conversion metric that the documented interface does not expose.
The practical launch test is small and strict
First confirm that the publication appears in Google's source preferences tool at the exact domain or subdomain users will recognize. Then deploy the standard button in one earned-value location, verify automatic localization and return behavior, and check light and dark treatments against the surrounding page. Only after that evidence should the team consider a custom trigger or broader placement test.
The feature is valuable precisely because it does not promise too much. It gives loyal readers a direct way to express source preference and gives publications a cleaner route back into personalized discovery. The winning SEO move is therefore not to maximize button impressions. It is to make the publication worth choosing, ask at the right moment and preserve the reader's context when Google records the choice.
Questions publishers may still have
Does adding the button improve rankings for every user?
No. Google describes a user-level preference that can make the selected source more likely to appear for that person in Top Stories and add a preferred badge in supported AI experiences.
Must a site add the button to be eligible?
No. Google says the integrations help readers find and select a source. They are not required for the site to appear in the source preferences tool.
Can a subdirectory become its own preferred source?
No. Google documents domain and subdomain eligibility, but not subdirectories. A section at example.com/news cannot be selected independently in the documented tool.
What if the CMS cannot run the JavaScript button?
Use the documented deeplink to Google's source preferences tool. It can be placed in a text link, image, newsletter or social post.
Official Google documentation
Google materials checked 22 August 2026
- Help your readers find your site through preferred sources in Google Search, Google Search Central, updated 20 August 2026.
- Latest Google Search documentation updates, entry for 20 August 2026.
- Google source preferences tool, accessed 22 August 2026.
- Google Preferred Sources implementation demo, accessed 22 August 2026.




