Method: use videos, audio, animations, and interactive graphics. Keep them short and relevant, place them next to the text they illustrate, and make sure all media is properly licensed.
Embedded video
A short video shows a workflow that is hard to describe in words. This is a ClickHelp tutorial embedded from YouTube — press play:
In ClickHelp: Insert → Insert YouTube Video, paste the URL. Vimeo, Wistia and other hosts work via their embed code. Open on YouTube ↗
Narrated audio with a live transcript
Audio helps with narrated tips and accessibility. Press Listen: the tip is read aloud and the transcript highlights each sentence as it's spoken.
Animated UI demo
An animation shows exactly where to click. This one demonstrates how to insert a video into a ClickHelp topic. Press Play, or step through it at your own pace.
▶ Play‹ BackNext ›↺ Reset
Good practice
| Do | Avoid |
|---|---|
| Keep videos short and focused on one task | Long recordings covering everything |
| Provide captions and transcripts | Media as the only source of the information |
| Use licensed or your own media | Images or music without rights to use them |
| Place media next to the related text | A gallery of videos at the bottom of the page |