The GoDAM Developer SDK allows developers to extend and customize the GoDAM video player using JavaScript. With a simple, well-structured API, you can create interactive video experiences, control playback, and dynamically insert custom layers, making your videos more engaging and data-driven.

Whether you’re building learning modules, gamified training, or marketing videos with interactive overlays, the SDK gives you direct access to player instances and their full functionality.

You can read the full documentation here. For an example implementation, continue reading below.

Overview

The GoDAM SDK provides access to the global JavaScript object window.GoDAMAPI, which exposes methods to:

Retrieve all players currently embedded on a page
Control playback (play, pause, seek, etc.)
Create and manage custom layers such as forms, quizzes, or end-screens
Listen for player events and react in real time

With these tools, developers can integrate the GoDAM player seamlessly into any workflow or website.

Prerequisites

Before using the SDK, ensure that:

The GoDAM plugin is installed and activated on your WordPress site.
A GoDAM player is embedded on the page (via shortcode, block, or API).
Your JavaScript file is properly enqueued within your theme or plugin.

Getting Started

1. Create Your JavaScript File

Create a file such as developer-sdk-demo.js in your theme or plugin’s /js/ directory.

2. Enqueue the Script

Add this to your theme’s functions.php or plugin file:

Implementation Guide

Step 1: Basic Setup

Start by ensuring the SDK is loaded and that at least one GoDAM player is available on the page.

Behavior:

Verifies that window.GoDAMAPI is loaded.
Ensures at least one GoDAM player exists.
Accesses the first available player.
Initializes any necessary state or flags for your logic.

Step 2: Create Quiz Layer

Add this immediately after your setup code within the function.
This layer displays a multiple-choice question at 50% of the video progress and pauses playback while active.

Key Properties:

displayTime: '50%' – Displays when the video reaches 50% progress.
backgroundColor: 'rgba(0, 0, 0, 0.85)' – Adds a semi-transparent overlay.
pauseOnShow: true – Pauses playback automatically.
onShow – Handles interactivity and button click logic.

Output:

Step 3: Create End Screen

Add this code after your quiz layer to show an interactive end screen at 100% playback.
It includes a message, a resource link, and a replay button.

Key Properties:

displayTime: '100%' – Shows when playback completes.
pauseOnShow: true – Pauses video automatically when shown.
backgroundColor: 'rgba(0, 0, 0, 0.85)' – Dark semi-transparent overlay.
onShow – Defines hover effects and replay logic.

Output:

Code Breakdown

Both layers follow the same API pattern:

Function / Property	Description
`player.createLayer(options)`	Creates a new layer overlay.
`displayTime`	Time (in % or seconds) when the layer appears.
`pauseOnShow`	Pauses video when the layer is displayed.
`onShow(el, p)`	Callback that fires when the layer becomes visible.
`el.dismiss()`	Removes the layer overlay.
`p.play()`	Resumes video playback.
`p.seek(0)`	Rewinds the player to the beginning.

The GoDAM Developer API enables developers to deeply customise and extend the GoDAM video player using JavaScript. Through the global window.GoDAMAPI object, you can retrieve player instances, control playback, create interactive layers (such as quizzes, polls or end-screens), and bind custom logic to player events. This powerful interface allows you to transform standard video playback into rich, engaging experiences that align with your branding and business workflows.

For full technical details of the API, see the GitHub README: GoDAM Player API.