---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/segment/connections/sources/plugins/vimeo#article
headline: analytics.js Vimeo Plugin
url: https://www.twilio.com/docs/segment/connections/sources/plugins/vimeo
inLanguage: en
dateModified: 2026-06-25T22:35:15.000Z
author:
  "@type": Organization
  name: Twilio Developer Education Team
publisher:
  "@type": Organization
  name: Twilio
---

# analytics.js Vimeo Plugin

The analytics.js Vimeo Plugin collects Vimeo player events into the Segment ecosystem.

## Getting Started

To use the plugin you must first generate an Access Token in Vimeo. The plugin uses this token to access metadata about the video content being played.

Vimeo provides documentation outlining this process in the Vimeo [The Basics](https://developer.vimeo.com/api/start#getting-started-step1) documentation. Make sure you are carefully selecting your access scopes. The plugin only needs to read information about your video(s).

### 1. Enable

Enable a new plugin by navigating to the settings for your Source and clicking **Plugins**. You can enable the Vimeo plugin from this menu.

![Plugins settings showing YouTube and Vimeo with toggle switches.](https://docs-resources.prod.twilio.com/9fcc541057bf36fb5d6809969cd96a7b497b0018e9eb035d8e3c15f6af88d7a3.png)

**NOTE:** Only JavaScript sources support plugins.

### 2. Initialize

Initialize the plugin by giving it your Vimeo Access Token, and granting it access to the Vimeo video player instance(s) running on the page. Do this using the initialize method:

```html
<iframe src="https://player.vimeo.com/video/76979871" width="640" height="360" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen></iframe>
<script src="https://player.vimeo.com/api/player.js"></script>
<script>
    var iframe = document.querySelector('iframe');
    var player = new Vimeo.Player(iframe);
    var VimeoAnalytics = window.analyticsPlugins.VimeoAnalytics
    <b>var vimeoAnalytics = new VimeoAnalytics(player, 'XXXXXXXXXXXXXXXXXXXXXXXXXXXX0365')
    vimeoAnalytics.initialize()</b>
</script>
```

The plugin listens to the Vimeo player for events, and responds by firing the corresponding [Segment Video Spec](/docs/segment/connections/spec/video/) events on Analytics.js.

## Supported Events

The following [Segment Video Spec](/docs/segment/connections/spec/video/) events are tracked by this plugin:

* Video Playback Started
* Video Playback Completed
* Video Playback Paused/Resumed
* Video Content Started/Completed

## Supported Properties

The following [Segment Video Spec](/docs/segment/connections/spec/video/) properties are automatically attached to the above events:

**'Playback' Events**

* Total Length
* Position
* Video Player
* Sound

**'Content' Events**

* Title
* Description
* Publisher