API Reference / API Parameters / analyticsTags
Type: list of strings
Engine default: []
Parameter syntax
'analyticsTags' => [
  'tag value',

Can be used in these methods:

About this parameter

List of tags to apply to the query for analytics purposes.

You can use tags in analytics to filter searches. For example, you can send two different tags - mobile and website - to see how mobile users search in comparison to website users.

There are a couple of limitations to keep in mind when sending analytics tags:

  • Tags can be up to 100 characters characters long. Longer tags are ignored.
  • Tags starting with alg# are reserved for internal usage and are ignored.
  • A query can have a maximum of 10 unique tags. Extra tags are ignored.
  • A maximum of 1750 unique tag combinations every 5 minutes unique tag combinations every 5 minutes. All extra tags are ignored. A tags combination is the list of tags found in a query. For example, sending three queries, each respectively tagged with ios, en, and ios,en, counts as 3 combinations.


$results = $index->search('query', [
  'analyticsTags' => [
Did you find this page helpful?