# Properties reference

import { DashButton } from "~/components";

Cloudflare Zaraz offers properties that you can use when configuring the product. They are helpful to send data to a third-party tool or to create triggers as they have context about a specific user's browser session and the actions they take on the website. Below is a list of the properties you can access from the Cloudflare dashboard and their values.

## Web API

| Property               | Description                                                                                                                                                                                                                                          |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *Event Name*           | Returns the name of the event sent using the Track method of the Web API. Refer to the [Track method](/zaraz/web-api/track/) for more information.                                                                                                   |
| *Track Property name:* | Returns the value of a `zaraz.track()` `eventProperties` key. The key can either be directly used in `zaraz.track()` or set using `zaraz.set()`. Set the name of your key here. Refer to the [Set method](/zaraz/web-api/set/) for more information. |

## Page Properties

| Property                  | Description                                                                                                            |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| *Page character encoding* | Returns the document character encoding from `document.characterSet`.                                                  |
| *Page referrer*           | Returns the page referrer from `document.referrer`.                                                                    |
| *Page title*              | Returns the page title.                                                                                                |
| *Query param name:*       | Returns the value of a URL query parameter. When you choose this variable, you need to set the name of your parameter. |
| *URL*                     | Returns a string containing the entire URL.                                                                            |
| *URL base domain*         | Returns the base domain part of the URL, without any subdomains.                                                       |
| *URL host*                | Returns the domain (that is, the hostname) followed by a `:` and the port of the URL (if a port was specified).        |
| *URL hostname*            | Returns the domain of the URL.                                                                                         |
| *URL origin*              | Returns the origin of the URL — that is, its scheme, domain, and port.                                                 |
| *URL password*            | Returns the password specified before the domain name.                                                                 |
| *URL pathname*            | Returns the path of the URL, including the initial `/`. Does not include the query string or fragment.                 |
| *URL port*                | Returns the port number of the URL.                                                                                    |
| *URL protocol scheme*     | Returns the protocol scheme of the URL, including the final `:`.                                                       |
| *URL query parameters*    | Returns query parameters provided, beginning with the leading `?` character.                                           |
| *URL username*            | Returns the username specified before the domain name.                                                                 |

## Cookies

| Property       | Description                                           |
| -------------- | ----------------------------------------------------- |
| *Cookie name:* | Returns cookies obtained from the browser `document`. |

## Device properties

| Property                   | Description                                                 |
| -------------------------- | ----------------------------------------------------------- |
| *Browser engine*           | Returns the type of browser engine (for example, `WebKit`). |
| *Browser engine version*   | Returns the version of the browser’s engine.                |
| *Browser name*             | Returns the browser’s name.                                 |
| *Browser version*          | Returns the browser’s version.                              |
| *Device CPU*               | Returns the device’s CPU.                                   |
| *Device IP address*        | Returns the incoming IP address.                            |
| *Device language*          | Returns the language used.                                  |
| *Device screen resolution* | Returns the screen resolution of the device.                |
| *Device type*              | Returns the type of device used (for example, `iPhone`).    |
| *Device viewport*          | Returns the visible web page area in user’s device.         |
| *Operating system name*    | Returns the operating system.                               |
| *Operating system version* | Returns the version of the operating system.                |
| *User-agent string*        | Returns the browser’s user agent.                           |

## Device location

| Property       | Description                                                                                                                                                                       |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *City*         | Returns the city of the incoming request. For example, `Lisbon`.                                                                                                                  |
| *Continent*    | Returns the continent of the incoming request. For example, `EU`                                                                                                                  |
| *Country* code | Returns the country code of the incoming request. For example, `PT`.                                                                                                              |
| *EU* country   | Returns a `1` if the country of the incoming request is in the European Union, and a `0` if it is not.                                                                            |
| *Region*       | Returns the [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) name for the first level region associated with the IP address of the incoming request. For example, `Lisbon`. |
| *Region* code  | Returns the [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) region code associated with the IP address of the incoming request. For example, `11`.                         |
| *Timezone*     | Returns the timezone of the incoming request. For example, `Europe/Lisbon`.                                                                                                       |

## Miscellaneous

| Property                   | Description                                     |
| -------------------------- | ----------------------------------------------- |
| *Random number*            | Returns a random number unique to each request. |
| *Timestamp (milliseconds)* | Returns the Unix time in milliseconds.          |
| *Timestamp (seconds)*      | Returns the Unix time in seconds.               |