# Chartbeat Destination

## Destination Info

* Accepts [Page](/docs/segment/connections/spec/page), [Alias](/docs/segment/connections/spec/alias), [Group](/docs/segment/connections/spec/group), [Identify](/docs/segment/connections/spec/identify), [Track](/docs/segment/connections/spec/track) calls.
* Refer to it as **Chartbeat** in the [Integrations object.](/docs/segment/guides/filtering-data/#filtering-with-the-integrations-object)

### Components

* [Browser](https://github.com/segment-integrations/analytics.js-integration-chartbeat)

## Connection Modes

[Learn more about connection modes.](/docs/segment/connections/destinations/#connection-modes)

### Device-Mode

* web: yes
* mobile: no
* server: no

### Cloud-Mode

* web: no
* mobile: no
* server: no

Our Chartbeat destination code is open-source on GitHub if you want to [check it out](https://github.com/segment-integrations/analytics.js-integration-chartbeat).

## Getting started

When you enable Chartbeat in the Segment web app, your changes appear in the Segment CDN in about 45 minutes, and then Analytics.js starts asynchronously loading `chartbeat.js` onto your page. This means you should remove Chartbeat's snippet from your page.

* Your Chartbeat real-time dashboard will start showing live concurrent visitors.

Chartbeat is only supported on the client-side.

## Page

The [`page`](/docs/segment/connections/spec/page/) method in Analytics.js will call Chartbeat's `virtualPage` function with either the Url you provide or the current window's pathname. Use the [`page`](/docs/segment/connections/spec/page/) method if you have a one-page app that doesn't reload the browser page between views.

You can also set a section and author for each page. For example, `analytics.page('putSectionHere', 'putNameOfPageHere', { author: 'putAuthorNameHere' }`.

## Settings

Segment lets you change these destination settings from the Segment app without having to touch any code.

| Field                      | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | Required | Type    |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------- |
| Domain                     | The same domain name you entered when adding your site's dashboard to Chartbeat. Don't include the \`www.\` because Chartbeat handles that for you automatically.                                                                                                                                                                                                                                                                                                                                           | Yes      | string  |
| sendNameAndCategoryAsTitle | \[Chartbeat expects]\(http://support.chartbeat.com/docs/#titles) the \`document.title\` ( Segment \`page\`'s \`props.title\`) to populate as \*title\*. &#xA;\</br>&#xA;\</br>&#xA;&#xA;This setting respects Segment's legacy behavior of setting the page name and category as \*title\* for existing users, but defaults new users to the correct behavior of sending \`document.title\` as \*title\* to Chartbeat, and allows current users to opt-in to the correct behavior if they chose. &#xA;&#xA; | No       | boolean |
| UID                        | You can find your UID on the Chartbeat \[Adding The Code]\(https://chartbeat.com/docs/adding\_the\_code/) page.                                                                                                                                                                                                                                                                                                                                                                                             | Yes      | string  |
| Use Chartbeat Video Script | If you select this option, we'll load \`chartbeat\_video.js\` instead of \`chartbeat.js\`. The video library has the ability to listen for play/pause events from HTML5 \`video\` tags and common 3rd party video players.                                                                                                                                                                                                                                                                                  | No       | boolean |
