Skip to content

Bot tags

Last updated View as MarkdownAgent setup

Bot tags provide more detail about why Cloudflare assigned a bot score to a request.

Use these tags to learn more about your bot traffic and better inform security settings.

Potential values

Once you enable bot tags, you can see more information about bot requests, such as whether a request came from a verified bot (like Bing) or a category of verified bot (like SearchEngine).

The following values are examples of what may be present in the BotTags log field, but not an exhaustive list:

  • api
  • google
  • bing
  • googleAds
  • googleMedia
  • googleImageProxy
  • pinterest
  • newRelic
  • baidu
  • apple
  • yandex

When matching the Ruleset Engine field, use uppercase tag values such as API, GOOGLE, or BING.

Use bot tags

To include bot tags in logs, add the BotTags field when using Logpush.

To match bot tags in Ruleset Engine expressions, use the cf.bot_management.tags field. For example:

any(cf.bot_management.tags[*] eq "API")

Was this helpful?