> For the complete documentation index, see [llms.txt](https://rudderlabs.gitbook.io/rudderlabs-1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rudderlabs.gitbook.io/rudderlabs-1/docs/rudderstack-api/api-specification/rudderstack-spec/page.md).

# Page

Detailed technical description of the Page API call.

The `page` call lets you record your website's page views with any additional relevant information about the viewed page. Many destinations require the `page` events to be called at least once every page load.

The [RudderStack JavaScript SDK](https://rudderstack.com/docs/stream-sources/rudderstack-sdk-integration-guides/rudderstack-javascript-sdk/) includes a `page` call in its snippet just after the `rudderanalytics.load` method.

## Sample payload

A sample payload of a `page` call with most of the [**Common Fields**](https://rudderstack.com/docs/rudderstack-api/api-specification/rudderstack-spec/common-fields/) removed is as shown:

```javascript
{
  "type": "page",
  "name": "Home",
  "properties": {
    "title": "Home | RudderStack",
    "url": "http://www.rudderstack.com"
  }
}
```

The corresponding event that generates the above payload via the JavaScript SDK is as shown:

```javascript
rudderanalytics.page("Home")
```

The SDK automatically gathers the page `name` and `url` and passes them into the event payload.

## Page fields

Apart from the [**Common Fields**](https://rudderstack.com/docs/rudderstack-api/api-specification/rudderstack-spec/common-fields/), the `page` call accepts the following fields:

| **Field**    | **Type** | **Presence** | **Description**                                                                                                                                                                                                                                |
| ------------ | -------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name`       | String   | Optional     | The name of the page.                                                                                                                                                                                                                          |
| `properties` | Object   | Optional     | Includes the properties of the page such as the `url`, `referrer`, etc. For more more information, check the [**Properties**](https://rudderstack.com/docs/rudderstack-api/api-specification/rudderstack-spec/page/#properties) section below. |

## Properties

Properties are additional information that describe the viewed page.

RudderStack has reserved some standard properties listed in the following table and handles them in a special manner. For instance, `path` should always be the URL path of the page and `referrer` should be the URL of the previously viewed page.

| **Property** | **Type** | **Description**                                                                                                                                                  |
| ------------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name`       | String   | The page name. This is a reserved property for future use.                                                                                                       |
| `path`       | String   | The path component of the page URL.                                                                                                                              |
| `url`        | String   | Full page URL. RudderStack first looks for the canonical URL. If it is not present, RudderStack uses the `location.href` component from the DOM API.             |
| `title`      | String   | The page title.                                                                                                                                                  |
| `referrer`   | String   | The full URL of the previous page visited by the user.                                                                                                           |
| `search`     | String   | The querystring component of the page URL.                                                                                                                       |
| `keywords`   | Array    | A list or array of keywords describing the page. These keywords are similar to the keywords used for SEO purposes. This property is not automatically collected. |

## Contact us

For queries on any of the sections covered in this guide, you can [**contact us**](mailto:%20docs@rudderstack.com) or start a conversation in our [**Slack**](https://rudderstack.com/join-rudderstack-slack-community) community.