> For the complete documentation index, see [llms.txt](https://attr.sygnal.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://attr.sygnal.com/sa5-detect/about.md).

# About SA5's Detect Lib

This this lib supports detection of your visitor characteristics, and actions based on them.

Initially we are focused on geo-detection using a GEOIP methodology. 

* Route users to specific pages depending on their location 

Coming soon; 

* Conditionally display elements depending on location  

## Future

User-agent detection, with accordant routing and conditional-vis;

* Language
* Device type
* Browser type
* etc. 

First time visitor detection. 

Referral detection. 

Onready callback 

Data binding 

### Detection Overrides

E.g. use case

dropdown showing countries

detected country selected 

changing forces a change on the country setting

*reloads page* to reapply detect with override setting 

Explicit overrides on detected UserInfo, such as the country, city, browser type... 

Set by script, 

window\.user-info-overrides 

set directly on overrides objects, via detect 

Saved data binds 

\>$detect.geo.country

Override Detects UserInfo? 

* Override country
* Override city
* Override language
* Override browser type

And remember - cache overrides? 

### Filter defaulting

Support for queries, like UserInfo load triggers, and the ability to e.g. trigger FS filters depending on those details automatically. 

Initialization only, once.