{"id":25493,"date":"2026-09-05T02:44:16","date_gmt":"2026-09-04T23:44:16","guid":{"rendered":"https:\/\/alienroad.com\/google-bilgi-bankasi\/help-your-readers-find-your-site-through-preferred-sources-in-google-search\/"},"modified":"2026-09-05T02:44:16","modified_gmt":"2026-09-04T23:44:16","slug":"help-your-readers-find-your-site-through-preferred-sources-in-google-search","status":"publish","type":"ar_kb","link":"https:\/\/alienroad.com\/google-bilgi-bankasi\/help-your-readers-find-your-site-through-preferred-sources-in-google-search\/","title":{"rendered":"Help your readers find your site through preferred sources in Google Search"},"content":{"rendered":"<p>\n  If you&#8217;re a website owner, you can help your audience find your publication<br \/>\n  as a preferred source in Google Search. When a user selects your site as a<br \/>\n  preferred source, your content is more likely to appear in<br \/>\n  &#8220;<a href=\"https:\/\/support.google.com\/websearch\/answer\/16379181\" class=\"external-link\">Top Stories<\/a>&#8220;,<br \/>\n  highlighted with a &#8220;preferred&#8221; badge. In AI Mode and AI Overviews, your<br \/>\n  content can be highlighted with a &#8220;preferred&#8221; badge for users who have<br \/>\n  selected your site as a preferred source.\n<\/p>\n<p><img decoding=\"async\" class=\"attempt-left\"\n     src=\"https:\/\/alienroad.com\/wp-content\/uploads\/kb-gorsel\/g-bab5a562a02d.png\" loading=\"lazy\"\n     alt=\"Preferred sources in AI Mode\"><br \/>\n<img decoding=\"async\" class=\"attempt-right\"\n     src=\"https:\/\/alienroad.com\/wp-content\/uploads\/kb-gorsel\/g-e2c22baa7e61.png\" loading=\"lazy\"\n     alt=\"Preferred sources in Top Stories\"><\/p>\n<h2 id=\"availability\" tabindex=\"-1\">Feature availability<\/h2>\n<p>\n  The preferred sources feature is available globally for the &#8220;Top Stories&#8221;<br \/>\n  feature in all languages where Google Search is available. Preferred sources<br \/>\n  can also appear in AI Mode and AI Overviews in all languages and locales<br \/>\n  where those features are available.\n<\/p>\n<p>\n  Only domain-level and subdomain-level sites are eligible to appear in the<br \/>\n  <a href=\"https:\/\/www.google.com\/preferences\/source\" class=\"external-link\">source preferences tool<\/a>.<br \/>\n  For example, <code>https:\/\/www.example.com\/<\/code> and<br \/>\n  <code>https:\/\/code.example.com\/<\/code> are eligible for preferred sources,<br \/>\n  but the subdirectory <code>https:\/\/www.example.com\/blog<\/code> isn&#8217;t<br \/>\n  eligible.\n<\/p>\n<h2 id=\"how-to\" tabindex=\"-1\">How to help users find your site as a preferred source<\/h2>\n<p>\n  If your site appears in the<br \/>\n  <a href=\"https:\/\/www.google.com\/preferences\/source\" class=\"external-link\">source preferences tool<\/a><br \/>\n  (to check, enter your site in the tool&#8217;s search box), you can use the<br \/>\n  following methods to guide your readers to select your site as a preferred<br \/>\n  source:\n<\/p>\n<ul>\n<li>\n    <a href=\"#standard-javascript\"><strong>Standard JavaScript implementation<\/strong><\/a><br \/>\n    <strong>(recommended)<\/strong>: Embed an interactive button to your web<br \/>\n    pages, which lets readers seamlessly add your site as a preferred source<br \/>\n    and returns them to your page. By adding only two lines to your HTML, this<br \/>\n    option renders an automatically localized, Google-styled button that<br \/>\n    supports device and language customization.\n  <\/li>\n<li>\n    <a href=\"#advanced-javascript\"><strong>Advanced JavaScript implementation with custom design assets<\/strong><\/a>:<br \/>\n    If you want to use your own design assets and customize the standard<br \/>\n    JavaScript button, follow the advanced JavaScript implementation<br \/>\n    instructions. The end-user UI flow remains the same as the standard<br \/>\n    JavaScript implementation.\n  <\/li>\n<li>\n    <a href=\"#deeplink\"><strong>Deeplink implementation<\/strong><\/a>: If you<br \/>\n    can&#8217;t implement the interactive button (for example, your CMS doesn&#8217;t<br \/>\n    support it), you can use a deeplink to direct people to adding your site<br \/>\n    as a preferred source. You can do this by adding a text link or a clickable<br \/>\n    image on your web pages. You can also use the deeplink in your social<br \/>\n    posts, email newsletters, or promotions.\n  <\/li>\n<\/ul>\n<aside class=\"note\">\n  These methods are examples of how you can build your audience and help people<br \/>\n  find your site as a preferred source. It&#8217;s not required to do them in order<br \/>\n  to appear as a preferred source.<br \/>\n<\/aside>\n<h3 id=\"standard-javascript\" tabindex=\"-1\">Standard JavaScript implementation (recommended)<\/h3>\n<p>\n  By adding only two lines to your HTML, you can add an automatically<br \/>\n  translated, interactive button, which lets readers seamlessly add your site<br \/>\n  as a preferred source and return to where they left off on your page. You can<br \/>\n  also set the theme of the button (dark or light), plus override the button<br \/>\n  language. We recommend this implementation because it provides the best user<br \/>\n  experience for readers.\n<\/p>\n<p>Here&#8217;s how it&#8217;ll look:<\/p>\n<p>\n  <img decoding=\"async\" src=\"https:\/\/alienroad.com\/wp-content\/uploads\/kb-gorsel\/g-838d3cf4a53a.png\" loading=\"lazy\"\n       alt=\"Add to preferred sources button with JavaScript\">\n<\/p>\n<p>To embed the JavaScript button on your web page, do the following:<\/p>\n<ol>\n<li>\n    Add the following <code>&lt;script&gt;<\/code> tag to your web page<br \/>\n    (preferably in the <code>&lt;head&gt;<\/code> element), which loads the<br \/>\n    Preferred Sources library.<\/p>\n<div><\/div>\n<\/li>\n<li>\n    Add the following <code>&lt;div&gt;<\/code> tag anywhere you&#8217;d like the<br \/>\n    button to appear in the body of your web page.<\/p>\n<div><\/div>\n<\/li>\n<\/ol>\n<h4 id=\"button-theme\" tabindex=\"-1\">Set the button theme<\/h4>\n<p>\n  By default, the &#8220;Add to Preferred Sources&#8221; button appears in a light theme.<br \/>\n  To adjust the theme, add the <code>data-theme<\/code> data attribute to your<br \/>\n  <code>&lt;div&gt;<\/code> element and set it to either <code>light<\/code> o<br \/>\n  <code>dark<\/code>:\n<\/p>\n<div><\/div>\n<h4 id=\"button-language\" tabindex=\"-1\">Override the button language<\/h4>\n<p>\n  By default, the &#8220;Add to Preferred Sources&#8221; button displays in the user&#8217;s<br \/>\n  language based on their browser settings. To override this behavior, add the<br \/>\n  <code>data-lang<\/code> data attribute to your <code>&lt;div&gt;<\/code><br \/>\n  element and set it to the language code you&#8217;d prefer (download the<br \/>\n  <a href=\"https:\/\/developers.google.com\/static\/search\/docs\/appearance\/preferred-sources-languages.csv\">list of supported language codes<\/a>):\n<\/p>\n<div><\/div>\n<p>\n  <a class=\"download external-link\"\n     href=\"https:\/\/developers.google.com\/static\/search\/docs\/appearance\/preferred-sources-languages.csv\">Download supported language codes<\/a>\n<\/p>\n<h3 id=\"advanced-javascript\" tabindex=\"-1\">Advanced JavaScript implementation with custom design assets<\/h3>\n<p>\n  By default, the standard JavaScript button automatically scans the DOM for<br \/>\n  elements with the <code>google-add-preferred-source-btn<\/code> attribute and<br \/>\n  renders the standard badge. However, for custom integrations where you want<br \/>\n  to trigger the flow from your own UI elements or application milestones, you<br \/>\n  can initialize the client programmatically and bind the flow to custom<br \/>\n  triggers.\n<\/p>\n<p>\n  When integrating the Preferred Sources library into custom user interfaces,<br \/>\n  application milestones, or modern framework applications, you can take full<br \/>\n  programmatic control over runtime settings and flow initiation using our<br \/>\n  JavaScript SDK. We provide two distinct integration approaches depending on<br \/>\n  your tooling and architecture: ES Module imports (ESM) and standard script<br \/>\n  callback queues (IIFE). Both distribution models expose identical<br \/>\n  capabilities and methods.\n<\/p>\n<h4 id=\"esm\" tabindex=\"-1\">ES Module imports<\/h4>\n<p>\n  For modern build setups and module-based environments, import the library<br \/>\n  directly into your code.\n<\/p>\n<div><\/div>\n<h4 id=\"standard-script\" tabindex=\"-1\">Standard script callback queues<\/h4>\n<p>\n  For standard script tag integrations, load the following script in the<br \/>\n  <code>&lt;head&gt;<\/code> of your document with the<br \/>\n  <code>preferred-sources-control=\"manual\"<\/code> attribute to prevent<br \/>\n  automatic button rendering:\n<\/p>\n<div><\/div>\n<aside class=\"note\">\n  <strong>Note<\/strong>: If the <code>preferred-sources-control=\"manual\"<\/code><br \/>\n  attribute is omitted, it&#8217;ll search for and immediately initialize any<br \/>\n  elements with the <code>google-add-preferred-source-btn<\/code> attribute.<br \/>\n<\/aside>\n<p>\n  Then use the global <code>PREFERRED_SOURCE<\/code> callback queue to<br \/>\n  initialize options and bind custom triggers:\n<\/p>\n<div><\/div>\n<p>\n  For interactive frontend and backend implementations showcasing live usage<br \/>\n  across buttons, declarative containers, IIFE scripts, and ES Module bundles,<br \/>\n  explore the<br \/>\n  <a href=\"https:\/\/reader-revenue-demo.ue.r.appspot.com\/preferred-sources\/esm\" class=\"external-link\">Preferred Sources demo<\/a>.\n<\/p>\n<h3 id=\"deeplink\" tabindex=\"-1\">Deeplink implementation<\/h3>\n<p>\n  If you can&#8217;t use JavaScript on your website, you can alternatively use a<br \/>\n  deeplink to direct your users to the<br \/>\n  <a href=\"https:\/\/www.google.com\/preferences\/source\" class=\"external-link\">source preferences tool<\/a>,<br \/>\n  where they can add your site as a preferred source and confirm their<br \/>\n  selection.\n<\/p>\n<p>\n  Use the following URL format and replace <code>example.com<\/code> with your<br \/>\n  publication&#8217;s domain name, which takes users directly to your site in the<br \/>\n  <a href=\"https:\/\/www.google.com\/preferences\/source\" class=\"external-link\">source preferences tool<\/a>:\n<\/p>\n<div><\/div>\n<h4 id=\"example-text-link\" tabindex=\"-1\">Example text link<\/h4>\n<div><\/div>\n<h4 id=\"example-clickable-image-link\" tabindex=\"-1\">Example clickable image link<\/h4>\n<div><\/div>\n<h4 id=\"button-image-assets\" tabindex=\"-1\">Button image assets<\/h4>\n<p>\n  You can design your own custom promotion badge or download official<br \/>\n  translated graphic assets provided by Google:\n<\/p>\n<p>\n  <a class=\"download external-link\"\n     href=\"https:\/\/services.google.com\/fh\/files\/helpcenter\/google_preferred_source_badge_all_languages.zip\">Download button assets<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Learn about the eligibility criteria for preferred sources in Google Search, and how to guide users to select your site as a preferred source in Google Search.<\/p>\n","protected":false},"menu_order":68,"template":"","meta":{"footnotes":""},"ar_kb_kategori":[670],"ar_kb_etiket":[],"class_list":["post-25493","ar_kb","type-ar_kb","status-publish","has-post-thumbnail","hentry","ar_kb_kategori-ranking-and-search-appearance"],"_links":{"self":[{"href":"https:\/\/alienroad.com\/wp-json\/wp\/v2\/ar_kb\/25493","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/alienroad.com\/wp-json\/wp\/v2\/ar_kb"}],"about":[{"href":"https:\/\/alienroad.com\/wp-json\/wp\/v2\/types\/ar_kb"}],"version-history":[{"count":0,"href":"https:\/\/alienroad.com\/wp-json\/wp\/v2\/ar_kb\/25493\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/alienroad.com\/wp-json\/wp\/v2\/media\/27529"}],"wp:attachment":[{"href":"https:\/\/alienroad.com\/wp-json\/wp\/v2\/media?parent=25493"}],"wp:term":[{"taxonomy":"ar_kb_kategori","embeddable":true,"href":"https:\/\/alienroad.com\/wp-json\/wp\/v2\/ar_kb_kategori?post=25493"},{"taxonomy":"ar_kb_etiket","embeddable":true,"href":"https:\/\/alienroad.com\/wp-json\/wp\/v2\/ar_kb_etiket?post=25493"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}