Overview of the visitor.js API

Available variables

After linking to the visitor.js script from your web page, the visitor object gives you access to various pieces of information about the user currently visiting your website.


IP Address
Variable Short Description Value (from your session)
visitor.ip.address IP address of the visitor's Internet connection. Please enable JavaScript.
Geographical Location
Variable Short Description Value (from your session)
visitor.geo.continentCode Two-letter code for the visitor's continent. Please enable JavaScript.
visitor.geo.continentName Full name of the visitor's continent. Please enable JavaScript.
visitor.geo.countryCode Two-letter ISO 3166 code for the visitor's country. Please enable JavaScript.
visitor.geo.countryName Full name of the visitor's country. Please enable JavaScript.
visitor.geo.city Full name of the visitor's city or town. Please enable JavaScript.
visitor.geo.postalCode The visitor's zip/postal code. Please enable JavaScript.
visitor.geo.coordinates.latitude Latitude of the city where the IP address is located. Please enable JavaScript.
visitor.geo.coordinates.longitude Longitude of the city where the IP address is located. Please enable JavaScript.
Language/Locale
Variable Short Description Value (from your session)
visitor.locale.languageCode Two-letter ISO-639-1 code for the browser's default/preferred language. Please enable JavaScript.
visitor.locale.countryCode Two-letter ISO-3166 country code that the browser's default language is localized for. Please enable JavaScript.
Current Session
Variable Short Description Value (from your session)
visitor.session.entryPage.fullUrl URL of the first page the visitor landed on when arriving at the website. Please enable JavaScript.
visitor.session.sessionStart Date and time when the visitor landed on the website. Please enable JavaScript.
visitor.session.referral.url.fullUrl URL of the website that referred the visitor. Please enable JavaScript.
visitor.session.referral.search.engine Name of the search engine that referred the visitor. Please enable JavaScript.
visitor.session.referral.search.query Full search query that led the visitor to the website. Please enable JavaScript.
visitor.session.referral.search.terms Keywords used in the search query that led the visitor to the website. Please enable JavaScript.
visitor.session.visitCount Number of times the visitor has visited the site. Please enable JavaScript.
First/Initial Session
Variable Short Description Value (from your session)
visitor.firstSession.sessionStart Date and time when the visitor initially landed on the website. Please enable JavaScript.
visitor.firstSession.referral.url.fullUrl URL of the website that initially referred the visitor. Please enable JavaScript.
visitor.firstSession.referral.search.engine Name of the search engine that initially referred the visitor. Please enable JavaScript.
visitor.firstSession.referral.search.query Full search query that initially led the visitor to the website. Please enable JavaScript.
visitor.firstSession.referral.search.terms Keywords used in the search query that initially led the visitor to the website. Please enable JavaScript.
Web Browser
Variable Short Description Value (from your session)
visitor.browser.engine.name Name of the browser's layout engine. Please enable JavaScript.
visitor.browser.engine.versionMajor The browser engine's main version number. Please enable JavaScript.
visitor.browser.engine.versionMinor The browser engine's minor version number (the number after the dot). Please enable JavaScript.
visitor.browser.name Display name of the browser used by the visitor. Please enable JavaScript.
visitor.browser.versionMajor The browser's major version number. Please enable JavaScript.
visitor.browser.versionMinor The browser's minor version number (the number after the dot). Please enable JavaScript.
visitor.browser.plugins.flash.enabled Specifies whether the Flash plugin is enabled/available in the browser. Please enable JavaScript.
visitor.browser.plugins.flash.versionMajor The Flash plugin's major version number. Please enable JavaScript.
visitor.browser.plugins.flash.versionMinor The Flash plugin's minor version number (the number after the first dot). Please enable JavaScript.
visitor.browser.plugins.flash.versionRevision The Flash plugin's revision number (the number after the second dot). Please enable JavaScript.
visitor.browser.plugins.silverlight.enabled Specifies whether the Silverlight plugin is enabled/available in the browser. Please enable JavaScript.
visitor.browser.plugins.silverlight.versionMajor The Silverlight plugin's major version number. Please enable JavaScript.
visitor.browser.plugins.silverlight.versionMinor The Silverlight plugin's minor version number (the number after the dot). Please enable JavaScript.
visitor.browser.plugins.java.enabled Specifies whether Java is enabled/available in the browser. Please enable JavaScript.
Operating System
Variable Short Description Value (from your session)
visitor.os.name Family name of the operating system used by the visitor. Please enable JavaScript.
visitor.os.version Version/edition of the visitor's operating system. Please enable JavaScript.
(Mobile) Device
Variable Short Description Value (from your session)
visitor.device.name Family name of the mobile device used by the visitor. Please enable JavaScript.
visitor.device.version Version/edition of the visitor's mobile device. Please enable JavaScript.
visitor.device.screen.resolution Screen resolution of the visitor's device. Please enable JavaScript.
visitor.device.screen.width Screen width of the user's device in pixels. Please enable JavaScript.
visitor.device.screen.height Screen height of the user's device in pixels. Please enable JavaScript.