{"id":4664,"date":"2026-07-02T09:12:26","date_gmt":"2026-07-02T06:12:26","guid":{"rendered":"https:\/\/fastpixel.io\/?post_type=docs&#038;p=4664"},"modified":"2026-07-02T09:12:27","modified_gmt":"2026-07-02T06:12:27","password":"","slug":"user-agent-exclusions","status":"publish","type":"docs","link":"https:\/\/fastpixel.io\/fr\/docs\/user-agent-exclusions\/","title":{"rendered":"User-agent Exclusions"},"content":{"rendered":"<p class=\"wp-block-paragraph\">FastPixel lets you stop optimizing pages for specific visitors based on their <strong>user agent<\/strong>, the identifier that every browser, bot, or app sends with each request. When a visitor&#8217;s user agent matches one of your exclusions, FastPixel will:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>not<\/strong> trigger page optimization (the page isn&#8217;t added to the optimization queue)<\/li>\n\n\n\n<li><strong>not<\/strong> serve them a cached page, they receive the standard, unoptimized page instead.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Bots, crawlers, and monitoring services don&#8217;t benefit from optimization, so excluding them keeps them from consuming your <strong>pageviews usage<\/strong>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">How matching works<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Add <strong>one user agent per line<\/strong>.<\/li>\n\n\n\n<li>Matching is <strong>case-insensitive<\/strong> \u2014 <code>claude<\/code>, <code>Claude<\/code>, and <code>CLAUDE<\/code> all behave the same.<\/li>\n\n\n\n<li>Matching is a <strong>&#8220;contains&#8221; check<\/strong> \u2014 FastPixel looks for your text <em>anywhere<\/em> inside the visitor&#8217;s full user-agent string, so you only need a distinctive part of it, not the whole thing.<\/li>\n\n\n\n<li>The <code>*<\/code> character can be used as a <strong>wildcard<\/strong> for more advanced patterns.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Example:<\/strong> a visitor whose user agent is <code>Mozilla\/5.0 (Macintosh; Intel Mac OS X 10_15_7) \u2026 Safari\/537.36, ClaudeBot\/1.2<\/code>\u00a0is excluded if you simply add <code>Claude<\/code>, because that word appears in the string.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">User agents excluded by default<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">FastPixel already excludes a set of common bots, scrapers, and monitoring services out of<br>the box. <strong>You don&#8217;t need to add these,  they&#8217;re always active<\/strong>, even though they don&#8217;t<br>appear within the plugin:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Search engine crawlers<\/strong><br>Googlebot, Bingbot, msnbot, Slurp, DuckDuckBot, Baiduspider, YandexBot, Sogou, Exabot, Applebot, PetalBot, SeznamBot, Qwantify, MojeekBot<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>AI crawlers &amp; assistants<\/strong><br>GPTBot, ChatGPT, OAI-SearchBot, ClaudeBot, Claude-Web, anthropic-ai, PerplexityBot, Perplexity-User, CCBot, GoogleOther, Amazonbot, Bytespider, Meta-ExternalAgent, FacebookBot, Diffbot, ImagesiftBot, Omgilibot, YouBot, cohere-ai, DuckAssistBot, AI2Bot, Timpibot, PanguBot<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>SEO &amp; backlink crawlers<\/strong><br>AhrefsBot, SemrushBot, MJ12bot, DotBot, BLEXBot, rogerbot<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Social &amp; link-preview scrapers<\/strong><br>facebookexternalhit, Facebot, Twitterbot, LinkedInBot, Pinterest, Slackbot, TelegramBot, WhatsApp, Discordbot<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Uptime &amp; availability monitors<\/strong><br>UptimeRobot, StatusCake, Site24x7<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The <strong>User-agent Exclusions<\/strong> field is only for the entries <em>you<\/em> add. Your additions are<br>combined with the built-in list above.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Tips<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Be specific.<\/strong> Because matching is a &#8220;contains&#8221; check, a short word can match more than<br>you expect (for example, <code>bot<\/code> would match many user agents). Use a distinctive token, and<br>add surrounding characters like <code>Claude\/<\/code> \u2014 if you need to narrow it down.<\/li>\n\n\n\n<li><strong>Use <code>*<\/code> for patterns.<\/strong> For example, <code>*PreviewBot*<\/code> matches any user agent containing<br>&#8220;PreviewBot&#8221;.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Performance-testing tools are never excluded<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Tools that measure your site&#8217;s speed are <strong>always served the cached, optimized page<\/strong>, so<br>your scores reflect the optimized version and <strong>cannot be excluded<\/strong>, even if you add a<br>matching entry. This protection covers Google PageSpeed Insights \/ Lighthouse, GTmetrix,<br>Pingdom, and WebPageTest.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>","protected":false},"excerpt":{"rendered":"<p>FastPixel lets you stop optimizing pages for specific visitors based on their user agent, the identifier that every browser, bot, or app sends with each request. When a visitor&#8217;s user agent matches one of your exclusions, FastPixel will: Bots, crawlers, and monitoring services don&#8217;t benefit from optimization, so excluding them keeps them from consuming your [&hellip;]<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_uag_custom_page_level_css":"","footnotes":""},"doc_category":[],"doc_tag":[],"class_list":["post-4664","docs","type-docs","status-publish","hentry"],"blocksy_meta":[],"year_month":"2026-07","word_count":398,"total_views":"18","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"Adrian","author_nicename":"adrian","author_url":"https:\/\/fastpixel.io\/fr\/blog\/author\/adrian\/"},"doc_category_info":[],"doc_tag_info":[],"knowledge_base_info":[],"knowledge_base_slug":[],"uagb_featured_image_src":{"full":false,"thumbnail":false,"medium":false,"medium_large":false,"large":false,"1536x1536":false,"2048x2048":false,"trp-custom-language-flag":false,"betterdocs-category-thumb":false},"uagb_author_info":{"display_name":"Adrian","author_link":"https:\/\/fastpixel.io\/fr\/blog\/author\/adrian\/"},"uagb_comment_info":0,"uagb_excerpt":"FastPixel lets you stop optimizing pages for specific visitors based on their user agent, the identifier that every browser, bot, or app sends with each request. When a visitor&#8217;s user agent matches one of your exclusions, FastPixel will: Bots, crawlers, and monitoring services don&#8217;t benefit from optimization, so excluding them keeps them from consuming your\u2026","_links":{"self":[{"href":"https:\/\/fastpixel.io\/fr\/wp-json\/wp\/v2\/docs\/4664","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/fastpixel.io\/fr\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/fastpixel.io\/fr\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/fastpixel.io\/fr\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/fastpixel.io\/fr\/wp-json\/wp\/v2\/comments?post=4664"}],"version-history":[{"count":2,"href":"https:\/\/fastpixel.io\/fr\/wp-json\/wp\/v2\/docs\/4664\/revisions"}],"predecessor-version":[{"id":4666,"href":"https:\/\/fastpixel.io\/fr\/wp-json\/wp\/v2\/docs\/4664\/revisions\/4666"}],"wp:attachment":[{"href":"https:\/\/fastpixel.io\/fr\/wp-json\/wp\/v2\/media?parent=4664"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/fastpixel.io\/fr\/wp-json\/wp\/v2\/doc_category?post=4664"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/fastpixel.io\/fr\/wp-json\/wp\/v2\/doc_tag?post=4664"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}