Course Card Build and above
The Course Card is a single tile that previews a course and opens it in place. Use it when you want to feature a specific course in context without giving over the whole page to it. The example below uses a sample course, with the card opening the full course inline when clicked.
It works well as a dashboard widget pointing to a recipient's next training, a recommendation slot inside a help article, a tile in a wider product layout, or anywhere a single course needs to be promoted alongside other content. It's the most compact way to put one course in front of someone.
Give the host <iframe> a descriptive title so recipients can identify the embedded content.
API Endpoint
/v1/headless/embed/course/cardBody parameters
| Field | Type | Example | Description | Demo Value |
|---|---|---|---|---|
action | viewedit | view | Determines the target action when the card is clicked. | |
courseId | number | 123 | — | — |
identifier | string | your-user-id | — | — |
clientIdentifier | string | your-tenant-id | — | — |
navigate | nativeeventnone | "native" | Controls card click behaviour. | |
options.fill | boolean | true | When true, the card fills the iframe. Otherwise, the card is centered at intrinsic size. | |
options.language | string | — | Set options.language to the BCP-47 language code used by the card frame (for example, fr or en-AU). | |
options.expiresIn | string | 3h | Link opening lifetime, "30s" to "3h" (e.g. "5m"). Invalid values return 400. Course links opened from inside keep 3h. |
Navigation events require the API authoring add-on. With events unavailable, navigate: 'event' opens the item's URL using native navigation. Use navigate: 'none' for a non-interactive card.
Emitted Events
How to listen to events| Type | Event | Description | Notes |
|---|---|---|---|
navigation | open | Fires when the card is clicked with navigate set to "event". | Payload includes url, embeddable, id, and action. |